feat: update GAPIC samples to be featured in create message guide (#1092)

* feat: update GAPIC samples to be featured in create message guide

* Fix style

---------

Co-authored-by: pierrick <pierrick@google.com>

Author: PierrickVoulet

chat/client-libraries/cloud/src/main/java/com/google/workspace/api/chat/samples/CreateMessageAppCred.java

@@ -18,6 +18,19 @@
 
 import com.google.protobuf.util.JsonFormat;
 // [START chat_CreateMessageAppCred]
+import com.google.apps.card.v1.Button;
+import com.google.apps.card.v1.ButtonList;
+import com.google.apps.card.v1.Card;
+import com.google.apps.card.v1.Icon;
+import com.google.apps.card.v1.MaterialIcon;
+import com.google.apps.card.v1.OnClick;
+import com.google.apps.card.v1.OpenLink;
+import com.google.apps.card.v1.TextParagraph;
+import com.google.apps.card.v1.Widget;
+import com.google.apps.card.v1.Card.CardHeader;
+import com.google.apps.card.v1.Card.Section;
+import com.google.chat.v1.AccessoryWidget;
+import com.google.chat.v1.CardWithId;
 import com.google.chat.v1.ChatServiceClient;
 import com.google.chat.v1.CreateMessageRequest;
 import com.google.chat.v1.Message;
@@ -28,16 +41,47 @@ public class CreateMessageAppCred {
   public static void main(String[] args) throws Exception {
     try (ChatServiceClient chatServiceClient =
         AuthenticationUtils.createClientWithAppCredentials()) {
-      CreateMessageRequest request =
-        CreateMessageRequest.newBuilder()
+      CreateMessageRequest.Builder request = CreateMessageRequest.newBuilder()
         // Replace SPACE_NAME here.
         .setParent("spaces/SPACE_NAME")
-        .setMessage(
-            Message.newBuilder()
-            .setText("Hello with app credentials!")
-            .build())
-        .build();
-      Message response = chatServiceClient.createMessage(request);
+        .setMessage(Message.newBuilder()
+          .setText( "👋🌎 Hello world! I created this message by calling " +
+                    "the Chat API\'s `messages.create()` method.")
+          .addCardsV2(CardWithId.newBuilder().setCard(Card.newBuilder()
+            .setHeader(CardHeader.newBuilder()
+              .setTitle("About this message")
+              .setImageUrl("https://fonts.gstatic.com/s/i/short-term/release/googlesymbols/info/default/24px.svg"))
+            .addSections(Section.newBuilder()
+              .setHeader("Contents")
+              .addWidgets(Widget.newBuilder().setTextParagraph(TextParagraph.newBuilder().setText(
+                "🔡 <b>Text</b> which can include " +
+                "hyperlinks 🔗, emojis 😄🎉, and @mentions 🗣️.")))
+              .addWidgets(Widget.newBuilder().setTextParagraph(TextParagraph.newBuilder().setText(
+                "🖼️ A <b>card</b> to display visual elements " +
+                "and request information such as text 🔤, " +
+                "dates and times 📅, and selections ☑️.")))
+              .addWidgets(Widget.newBuilder().setTextParagraph(TextParagraph.newBuilder().setText(
+                "👉🔘 An <b>accessory widget</b> which adds " +
+                "a button to the bottom of a message."))))
+            .addSections(Section.newBuilder()
+              .setHeader("What's next")
+              .setCollapsible(true)
+              .addWidgets(Widget.newBuilder().setTextParagraph(TextParagraph.newBuilder().setText(
+                "❤️ <a href='https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.reactions/create'>Add a reaction</a>.")))
+              .addWidgets(Widget.newBuilder().setTextParagraph(TextParagraph.newBuilder().setText(
+                "🔄 <a href='https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages/patch'>Update</a> " +
+                "or ❌ <a href='https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages/delete'>delete</a> " +
+                "the message."))))))
+          .addAccessoryWidgets(AccessoryWidget.newBuilder()
+            .setButtonList(ButtonList.newBuilder()
+              .addButtons(Button.newBuilder()
+                .setText("View documentation")
+                .setIcon(Icon.newBuilder()
+                  .setMaterialIcon(MaterialIcon.newBuilder().setName("link")))
+                .setOnClick(OnClick.newBuilder()
+                  .setOpenLink(OpenLink.newBuilder()
+                    .setUrl("https://developers.google.com/workspace/chat/create-messages")))))));
+      Message response = chatServiceClient.createMessage(request.build());
 
       System.out.println(JsonFormat.printer().print(response));
     }

chat/client-libraries/cloud/src/main/java/com/google/workspace/api/chat/samples/CreateMessageAppCredWithCards.java

@@ -33,17 +33,19 @@ public static void main(String[] args) throws Exception {
     try (ChatServiceClient chatServiceClient =
         AuthenticationUtils.createClientWithUserCredentials(
           ImmutableList.of(SCOPE))) {
-      CreateMessageRequest request =
-        CreateMessageRequest.newBuilder()
+      CreateMessageRequest.Builder request = CreateMessageRequest.newBuilder()
         // Replace SPACE_NAME here.
         .setParent("spaces/SPACE_NAME")
-        .setMessage(
-            Message
-            .newBuilder()
-            .setText("Hello with user credentials!")
-            .build())
-        .build();
-      Message response = chatServiceClient.createMessage(request);
+        .setMessage(Message.newBuilder()
+          .setText( "👋🌎 Hello world!" +
+                    "Text messages can contain things like:\n\n" +
+                    "* Hyperlinks 🔗\n" +
+                    "* Emojis 😄🎉\n" +
+                    "* Mentions of other Chat users `@` \n\n" +
+                    "For details, see the " +
+                    "<https://developers.google.com/workspace/chat/format-messages" +
+                    "|Chat API developer documentation>."));
+      Message response = chatServiceClient.createMessage(request.build());
 
       System.out.println(JsonFormat.printer().print(response));
     }