feat: [google-apps-chat] add rich link annotation type (#12459)

BEGIN_COMMIT_OVERRIDE feat: add rich link annotation type END_COMMIT_OVERRIDE - [ ] Regenerate this pull request now. PiperOrigin-RevId: 615897483 Source-Link: googleapis/googleapis@f5ed6db Source-Link: googleapis/googleapis-gen@ce37bd9 Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWFwcHMtY2hhdC8uT3dsQm90LnlhbWwiLCJoIjoiY2UzN2JkOTk2NDIwY2JhMDQwNzUwMmMwNjFjMDJmYjRjNDlhZmE0YSJ9 --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com> Co-authored-by: ohmayr <omairnaveed@ymail.com>

Author: gcf-owl-bot[bot]

packages/google-apps-chat/google/apps/chat/__init__.py

@@ -26,6 +26,8 @@
 from google.apps.chat_v1.types.annotation import (
  Annotation,
  AnnotationType,
+ DriveLinkData,
+ RichLinkMetadata,
  SlashCommandMetadata,
  UserMentionMetadata,
 )
@@ -98,6 +100,8 @@
  "ChatServiceAsyncClient",
  "ActionStatus",
  "Annotation",
+ "DriveLinkData",
+ "RichLinkMetadata",
  "SlashCommandMetadata",
  "UserMentionMetadata",
  "AnnotationType",

packages/google-apps-chat/google/apps/chat_v1/__init__.py

@@ -23,6 +23,8 @@
 from .types.annotation import (
  Annotation,
  AnnotationType,
+ DriveLinkData,
+ RichLinkMetadata,
  SlashCommandMetadata,
  UserMentionMetadata,
 )
@@ -117,6 +119,7 @@
  "Dialog",
  "DialogAction",
  "DriveDataRef",
+ "DriveLinkData",
  "Emoji",
  "EmojiReactionSummary",
  "FindDirectMessageRequest",
@@ -139,6 +142,7 @@
  "Message",
  "QuotedMessageMetadata",
  "Reaction",
+ "RichLinkMetadata",
  "SetUpSpaceRequest",
  "SlashCommand",
  "SlashCommandMetadata",

packages/google-apps-chat/google/apps/chat_v1/services/chat_service/async_client.py

@@ -1626,7 +1626,7 @@ async def sample_get_space():
  The request object. A request to return a single space.
  name (:class:`str`):
  Required. Resource name of the space, in the form
- "spaces/*".
+ ``"spaces/*"``.
 
  Format: ``spaces/{space}``
 

packages/google-apps-chat/google/apps/chat_v1/services/chat_service/client.py

@@ -2044,7 +2044,7 @@ def sample_get_space():
  The request object. A request to return a single space.
  name (str):
  Required. Resource name of the space, in the form
- "spaces/*".
+ ``"spaces/*"``.
 
  Format: ``spaces/{space}``
 

packages/google-apps-chat/google/apps/chat_v1/types/__init__.py

@@ -17,6 +17,8 @@
 from .annotation import (
  Annotation,
  AnnotationType,
+ DriveLinkData,
+ RichLinkMetadata,
  SlashCommandMetadata,
  UserMentionMetadata,
 )
@@ -87,6 +89,8 @@
 __all__ = (
  "ActionStatus",
  "Annotation",
+ "DriveLinkData",
+ "RichLinkMetadata",
  "SlashCommandMetadata",
  "UserMentionMetadata",
  "AnnotationType",

packages/google-apps-chat/google/apps/chat_v1/types/annotation.py

@@ -19,6 +19,7 @@
 
 import proto # type: ignore
 
+from google.apps.chat_v1.types import attachment
 from google.apps.chat_v1.types import user as gc_user
 
 __protobuf__ = proto.module(
@@ -28,6 +29,8 @@
  "Annotation",
  "UserMentionMetadata",
  "SlashCommandMetadata",
+ "RichLinkMetadata",
+ "DriveLinkData",
  },
 )
 
@@ -42,10 +45,13 @@ class AnnotationType(proto.Enum):
  A user is mentioned.
  SLASH_COMMAND (2):
  A slash command is invoked.
+ RICH_LINK (3):
+ A rich link annotation.
  """
  ANNOTATION_TYPE_UNSPECIFIED = 0
  USER_MENTION = 1
  SLASH_COMMAND = 2
+ RICH_LINK = 3
 
 
 class Annotation(proto.Message):
@@ -104,6 +110,10 @@ class Annotation(proto.Message):
  slash_command (google.apps.chat_v1.types.SlashCommandMetadata):
  The metadata for a slash command.
 
+ This field is a member of `oneof`_ ``metadata``.
+ rich_link_metadata (google.apps.chat_v1.types.RichLinkMetadata):
+ The metadata for a rich link.
+
  This field is a member of `oneof`_ ``metadata``.
  """
 
@@ -133,6 +143,12 @@ class Annotation(proto.Message):
  oneof="metadata",
  message="SlashCommandMetadata",
  )
+ rich_link_metadata: "RichLinkMetadata" = proto.Field(
+ proto.MESSAGE,
+ number=6,
+ oneof="metadata",
+ message="RichLinkMetadata",
+ )
 
 
 class UserMentionMetadata(proto.Message):
@@ -228,4 +244,73 @@ class Type(proto.Enum):
  )
 
 
+class RichLinkMetadata(proto.Message):
+ r"""A rich link to a resource.
+
+ .. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
+
+ Attributes:
+ uri (str):
+ The URI of this link.
+ rich_link_type (google.apps.chat_v1.types.RichLinkMetadata.RichLinkType):
+ The rich link type.
+ drive_link_data (google.apps.chat_v1.types.DriveLinkData):
+ Data for a drive link.
+
+ This field is a member of `oneof`_ ``data``.
+ """
+
+ class RichLinkType(proto.Enum):
+ r"""The rich link type. More types might be added in the future.
+
+ Values:
+ RICH_LINK_TYPE_UNSPECIFIED (0):
+ Default value for the enum. Don't use.
+ DRIVE_FILE (1):
+ A Google Drive rich link type.
+ """
+ RICH_LINK_TYPE_UNSPECIFIED = 0
+ DRIVE_FILE = 1
+
+ uri: str = proto.Field(
+ proto.STRING,
+ number=1,
+ )
+ rich_link_type: RichLinkType = proto.Field(
+ proto.ENUM,
+ number=2,
+ enum=RichLinkType,
+ )
+ drive_link_data: "DriveLinkData" = proto.Field(
+ proto.MESSAGE,
+ number=3,
+ oneof="data",
+ message="DriveLinkData",
+ )
+
+
+class DriveLinkData(proto.Message):
+ r"""Data for Google Drive links.
+
+ Attributes:
+ drive_data_ref (google.apps.chat_v1.types.DriveDataRef):
+ A
+ `DriveDataRef <https://developers.google.com/chat/api/reference/rest/v1/spaces.messages.attachments#drivedataref>`__
+ which references a Google Drive file.
+ mime_type (str):
+ The mime type of the linked Google Drive
+ resource.
+ """
+
+ drive_data_ref: attachment.DriveDataRef = proto.Field(
+ proto.MESSAGE,
+ number=1,
+ message=attachment.DriveDataRef,
+ )
+ mime_type: str = proto.Field(
+ proto.STRING,
+ number=2,
+ )
+
+
 __all__ = tuple(sorted(__protobuf__.manifest))

packages/google-apps-chat/google/apps/chat_v1/types/space.py

@@ -404,7 +404,7 @@ class GetSpaceRequest(proto.Message):
  Attributes:
  name (str):
  Required. Resource name of the space, in the form
- "spaces/*".
+ ``"spaces/*"``.
 
  Format: ``spaces/{space}``
  """

packages/google-apps-chat/tests/unit/gapic/chat_v1/test_chat_service.py

@@ -7007,6 +7007,14 @@ def test_create_message_rest(request_type):
  "command_id": 1035,
  "triggers_dialog": True,
  },
+ "rich_link_metadata": {
+ "uri": "uri_value",
+ "rich_link_type": 1,
+ "drive_link_data": {
+ "drive_data_ref": {"drive_file_id": "drive_file_id_value"},
+ "mime_type": "mime_type_value",
+ },
+ },
  }
  ],
  "thread": {"name": "name_value", "thread_key": "thread_key_value"},
@@ -7052,7 +7060,7 @@ def test_create_message_rest(request_type):
  "resource_name": "resource_name_value",
  "attachment_upload_token": "attachment_upload_token_value",
  },
- "drive_data_ref": {"drive_file_id": "drive_file_id_value"},
+ "drive_data_ref": {},
  "thumbnail_uri": "thumbnail_uri_value",
  "download_uri": "download_uri_value",
  "source": 1,
@@ -8941,6 +8949,14 @@ def test_update_message_rest(request_type):
  "command_id": 1035,
  "triggers_dialog": True,
  },
+ "rich_link_metadata": {
+ "uri": "uri_value",
+ "rich_link_type": 1,
+ "drive_link_data": {
+ "drive_data_ref": {"drive_file_id": "drive_file_id_value"},
+ "mime_type": "mime_type_value",
+ },
+ },
  }
  ],
  "thread": {"name": "name_value", "thread_key": "thread_key_value"},
@@ -8986,7 +9002,7 @@ def test_update_message_rest(request_type):
  "resource_name": "resource_name_value",
  "attachment_upload_token": "attachment_upload_token_value",
  },
- "drive_data_ref": {"drive_file_id": "drive_file_id_value"},
+ "drive_data_ref": {},
  "thumbnail_uri": "thumbnail_uri_value",
  "download_uri": "download_uri_value",
  "source": 1,