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

PierrickVoulet · pierrick · web-flow · commit cad240af43b6 · 2024-08-20T15:50:58.000-04:00
* feat: update GAPIC samples to be featured in create message guide

* nit fix

---------

Co-authored-by: pierrick &lt;pierrick@google.com&gt;
diff --git a/chat/client-libraries/cloud/create_message_app_cred.py b/chat/client-libraries/cloud/create_message_app_cred.py
@@ -32,7 +32,47 @@ def create_message_with_app_cred():
         # Replace SPACE_NAME here.
         parent = "spaces/SPACE_NAME",
         message = {
-            "text" : "Hello with app credential!"
+            "text": '&#128075;&#127758; Hello world! I created this message by calling ' +
+                    'the Chat API\'s `messages.create()` method.',
+            "cards_v2" : [{ "card": {
+                "header": {
+                    "title": 'About this message',
+                    "image_url": 'https://fonts.gstatic.com/s/i/short-term/release/googlesymbols/info/default/24px.svg'
+                },
+                "sections": [{
+                    "header": "Contents",
+                    "widgets": [{ "text_paragraph": {
+                            "text": '&#128289; <b>Text</b> which can include ' +
+                                    'hyperlinks &#128279;, emojis &#128516;&#127881;, and @mentions &#128483;&#65039;.'
+                        }}, { "text_paragraph": {
+                            "text": '&#128444;&#65039; A <b>card</b> to display visual elements' +
+                                    'and request information such as text &#128292;, ' +
+                                    'dates and times &#128197;, and selections &#9745;&#65039;.'
+                        }}, { "text_paragraph": {
+                            "text": '&#128073;&#128280; An <b>accessory widget</b> which adds ' +
+                                    'a button to the bottom of a message.'
+                        }}
+                    ]}, {
+                        "header": "What's next",
+                        "collapsible": True,
+                        "widgets": [{ "text_paragraph": {
+                                "text": "&#10084;&#65039; <a href='https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.reactions/create'>Add a reaction</a>."
+                            }}, { "text_paragraph": {
+                                "text": "&#128260; <a href='https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages/patch'>Update</a> " +
+                                        "or &#10060; <a href='https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages/delete'>delete</a> " +
+                                        "the message."
+                            }
+                        }]
+                    }
+                ]
+            }}],
+            "accessory_widgets": [{ "button_list": { "buttons": [{
+                "text": 'View documentation',
+                "icon": { "material_icon": { "name": 'link' }},
+                "on_click": { "open_link": {
+                    "url": 'https://developers.google.com/workspace/chat/create-messages'
+                }}
+            }]}}]
         }
     )
 
diff --git a/chat/client-libraries/cloud/create_message_app_cred_with_cards.py b/chat/client-libraries/cloud/create_message_app_cred_with_cards.py
diff --git a/chat/client-libraries/cloud/create_message_user_cred.py b/chat/client-libraries/cloud/create_message_user_cred.py
@@ -33,7 +33,14 @@ def create_message_with_user_cred():
         # Replace SPACE_NAME here.
         parent = "spaces/SPACE_NAME",
         message = {
-            "text": "Hello with user credential!"
+            "text": '&#128075;&#127758; Hello world!' +
+                    'Text messages can contain things like:\n\n' +
+                    '* Hyperlinks &#128279;\n' +
+                    '* Emojis &#128516;&#127881;\n' +
+                    '* Mentions of other Chat users `@` \n\n' +
+                    'For details, see the ' +
+                    '<https://developers.google.com/workspace/chat/format-messages' +
+                    '|Chat API developer documentation>.'
         }
     )
 
diff --git a/chat/client-libraries/cloud/requirements.txt b/chat/client-libraries/cloud/requirements.txt
@@ -1,3 +1,3 @@
 google_auth_oauthlib==1.2.0
 protobuf==4.21.12
-google-apps-chat==0.1.0
+google-apps-chat==0.1.9
