Skip to content

Commit

Permalink
owlbot updates
Browse files Browse the repository at this point in the history
  • Loading branch information
bshaffer committed Apr 16, 2024
1 parent ce63f61 commit 7096439
Show file tree
Hide file tree
Showing 98 changed files with 1,198 additions and 985 deletions.
Binary file modified AppsChat/metadata/Card/V1/Card.php
Binary file not shown.
Original file line number Diff line number Diff line change
Expand Up @@ -30,11 +30,11 @@

/**
* Completes the
* [import process](https://developers.google.com/chat/api/guides/import-data)
* [import process](https://developers.google.com/workspace/chat/import-data)
* for the specified space and makes it visible to users.
* Requires app authentication and domain-wide delegation. For more
* information, see [Authorize Google Chat apps to import
* data](https://developers.google.com/chat/api/guides/authorize-import).
* data](https://developers.google.com/workspace/chat/authorize-import).
*
* @param string $formattedName Resource name of the import mode space.
*
Expand Down
6 changes: 3 additions & 3 deletions AppsChat/samples/V1/ChatServiceClient/create_membership.php
Original file line number Diff line number Diff line change
Expand Up @@ -31,13 +31,13 @@
/**
* Creates a human membership or app membership for the calling app. Creating
* memberships for other apps isn't supported. For an example, see
* [ Create a
* membership](https://developers.google.com/chat/api/guides/v1/members/create).
* [Invite or add a user or a Google Chat app to a
* space](https://developers.google.com/workspace/chat/create-members).
* When creating a membership, if the specified member has their auto-accept
* policy turned off, then they're invited, and must accept the space
* invitation before joining. Otherwise, creating a membership adds the member
* directly to the specified space. Requires [user
* authentication](https://developers.google.com/chat/api/guides/auth/users).
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
*
* To specify the member to add, set the `membership.member.name` in the
* `CreateMembershipRequest`:
Expand Down
8 changes: 4 additions & 4 deletions AppsChat/samples/V1/ChatServiceClient/create_message.php
Original file line number Diff line number Diff line change
Expand Up @@ -29,12 +29,12 @@
use Google\Apps\Chat\V1\Message;

/**
* Creates a message in a Google Chat space. For an example, see [Create a
* message](https://developers.google.com/chat/api/guides/v1/messages/create).
* Creates a message in a Google Chat space. For an example, see [Send a
* message](https://developers.google.com/workspace/chat/create-messages).
*
* Calling this method requires
* [authentication](https://developers.google.com/chat/api/guides/auth) and
* supports the following authentication types:
* [authentication](https://developers.google.com/workspace/chat/authenticate-authorize)
* and supports the following authentication types:
*
* - For text messages, user authentication or app authentication are
* supported.
Expand Down
10 changes: 5 additions & 5 deletions AppsChat/samples/V1/ChatServiceClient/create_reaction.php
Original file line number Diff line number Diff line change
Expand Up @@ -29,12 +29,12 @@
use Google\Apps\Chat\V1\Reaction;

/**
* Creates a reaction and adds it to a message. For an example, see
* [Create a
* reaction](https://developers.google.com/chat/api/guides/v1/reactions/create).
* Creates a reaction and adds it to a message. Only unicode emojis are
* supported. For an example, see
* [Add a reaction to a
* message](https://developers.google.com/workspace/chat/create-reactions).
* Requires [user
* authentication](https://developers.google.com/chat/api/guides/auth/users).
* Only unicode emoji are supported.
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
*
* @param string $formattedParent The message where the reaction is created.
*
Expand Down
4 changes: 2 additions & 2 deletions AppsChat/samples/V1/ChatServiceClient/create_space.php
Original file line number Diff line number Diff line change
Expand Up @@ -31,14 +31,14 @@
/**
* Creates a named space. Spaces grouped by topics aren't supported. For an
* example, see [Create a
* space](https://developers.google.com/chat/api/guides/v1/spaces/create).
* space](https://developers.google.com/workspace/chat/create-spaces).
*
* If you receive the error message `ALREADY_EXISTS` when creating
* a space, try a different `displayName`. An existing space within
* the Google Workspace organization might already use this display name.
*
* Requires [user
* authentication](https://developers.google.com/chat/api/guides/auth/users).
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
*
* This sample has been automatically generated and should be regarded as a code
* template only. It will require modifications to work:
Expand Down
6 changes: 3 additions & 3 deletions AppsChat/samples/V1/ChatServiceClient/delete_membership.php
Original file line number Diff line number Diff line change
Expand Up @@ -30,11 +30,11 @@

/**
* Deletes a membership. For an example, see
* [Delete a
* membership](https://developers.google.com/chat/api/guides/v1/members/delete).
* [Remove a user or a Google Chat app from a
* space](https://developers.google.com/workspace/chat/delete-members).
*
* Requires [user
* authentication](https://developers.google.com/chat/api/guides/auth/users).
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
*
* @param string $formattedName Resource name of the membership to delete. Chat apps can delete
* human users' or their own memberships. Chat apps can't delete other apps'
Expand Down
10 changes: 5 additions & 5 deletions AppsChat/samples/V1/ChatServiceClient/delete_message.php
Original file line number Diff line number Diff line change
Expand Up @@ -30,15 +30,15 @@
/**
* Deletes a message.
* For an example, see [Delete a
* message](https://developers.google.com/chat/api/guides/v1/messages/delete).
* message](https://developers.google.com/workspace/chat/delete-messages).
*
* Requires
* [authentication](https://developers.google.com/chat/api/guides/auth).
* [authentication](https://developers.google.com/workspace/chat/authenticate-authorize).
* Supports
* [app
* authentication](https://developers.google.com/chat/api/guides/auth/service-accounts)
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
* and [user
* authentication](https://developers.google.com/chat/api/guides/auth/users).
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
* When using app authentication, requests can only delete messages
* created by the calling Chat app.
*
Expand All @@ -49,7 +49,7 @@
* If you've set a custom ID for your message, you can use the value from the
* `clientAssignedMessageId` field for `{message}`. For details, see [Name a
* message]
* (https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message). Please see
* (https://developers.google.com/workspace/chat/create-messages#name_a_created_message). Please see
* {@see ChatServiceClient::messageName()} for help formatting this field.
*/
function delete_message_sample(string $formattedName): void
Expand Down
7 changes: 4 additions & 3 deletions AppsChat/samples/V1/ChatServiceClient/delete_reaction.php
Original file line number Diff line number Diff line change
Expand Up @@ -28,11 +28,12 @@
use Google\Apps\Chat\V1\DeleteReactionRequest;

/**
* Deletes a reaction to a message. For an example, see
* Deletes a reaction to a message. Only unicode emojis are supported.
* For an example, see
* [Delete a
* reaction](https://developers.google.com/chat/api/guides/v1/reactions/delete).
* reaction](https://developers.google.com/workspace/chat/delete-reactions).
* Requires [user
* authentication](https://developers.google.com/chat/api/guides/auth/users).
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
*
* @param string $formattedName Name of the reaction to delete.
*
Expand Down
4 changes: 2 additions & 2 deletions AppsChat/samples/V1/ChatServiceClient/delete_space.php
Original file line number Diff line number Diff line change
Expand Up @@ -32,9 +32,9 @@
* that the space's child resources—like messages posted in the space and
* memberships in the space—are also deleted. For an example, see
* [Delete a
* space](https://developers.google.com/chat/api/guides/v1/spaces/delete).
* space](https://developers.google.com/workspace/chat/delete-spaces).
* Requires [user
* authentication](https://developers.google.com/chat/api/guides/auth/users)
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
* from a user who has permission to delete the space.
*
* @param string $formattedName Resource name of the space to delete.
Expand Down
12 changes: 6 additions & 6 deletions AppsChat/samples/V1/ChatServiceClient/find_direct_message.php
Original file line number Diff line number Diff line change
Expand Up @@ -35,19 +35,19 @@
* [Find a direct message](/chat/api/guides/v1/spaces/find-direct-message).
*
* With [user
* authentication](https://developers.google.com/chat/api/guides/auth/users),
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
* returns the direct message space between the specified user and the
* authenticated user.
*
* With [app
* authentication](https://developers.google.com/chat/api/guides/auth/service-accounts),
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app),
* returns the direct message space between the specified user and the calling
* Chat app.
*
* Requires [user
* authentication](https://developers.google.com/chat/api/guides/auth/users)
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
* or [app
* authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).
*
* @param string $name Resource name of the user to find direct message with.
*
Expand All @@ -58,8 +58,8 @@
* in the Directory API. For example, if the People API profile ID is
* `123456789`, you can find a direct message with that person by using
* `users/123456789` as the `name`. When [authenticated as a
* user](https://developers.google.com/chat/api/guides/auth/users), you can
* use the email as an alias for `{user}`. For example,
* user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
* you can use the email as an alias for `{user}`. For example,
* `users/example@gmail.com` where `example@gmail.com` is the email of the
* Google Chat user.
*/
Expand Down
8 changes: 4 additions & 4 deletions AppsChat/samples/V1/ChatServiceClient/get_attachment.php
Original file line number Diff line number Diff line change
Expand Up @@ -31,12 +31,12 @@
/**
* Gets the metadata of a message attachment. The attachment data is fetched
* using the [media
* API](https://developers.google.com/chat/api/reference/rest/v1/media/download).
* API](https://developers.google.com/workspace/chat/api/reference/rest/v1/media/download).
* For an example, see
* [Get a message
* attachment](https://developers.google.com/chat/api/guides/v1/media-and-attachments/get).
* [Get metadata about a message
* attachment](https://developers.google.com/workspace/chat/get-media-attachments).
* Requires [app
* authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).
*
* @param string $formattedName Resource name of the attachment, in the form
* `spaces/*/messages/*/attachments/*`. Please see
Expand Down
14 changes: 7 additions & 7 deletions AppsChat/samples/V1/ChatServiceClient/get_membership.php
Original file line number Diff line number Diff line change
Expand Up @@ -30,16 +30,16 @@

/**
* Returns details about a membership. For an example, see
* [Get a
* membership](https://developers.google.com/chat/api/guides/v1/members/get).
* [Get details about a user's or Google Chat app's
* membership](https://developers.google.com/workspace/chat/get-members).
*
* Requires
* [authentication](https://developers.google.com/chat/api/guides/auth).
* [authentication](https://developers.google.com/workspace/chat/authenticate-authorize).
* Supports
* [app
* authentication](https://developers.google.com/chat/api/guides/auth/service-accounts)
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
* and [user
* authentication](https://developers.google.com/chat/api/guides/auth/users).
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
*
* @param string $formattedName Resource name of the membership to retrieve.
*
Expand All @@ -49,8 +49,8 @@
* Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app`
*
* When [authenticated as a
* user](https://developers.google.com/chat/api/guides/auth/users), you can
* use the user's email as an alias for `{member}`. For example,
* user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
* you can use the user's email as an alias for `{member}`. For example,
* `spaces/{space}/members/example@gmail.com` where `example@gmail.com` is the
* email of the Google Chat user. Please see
* {@see ChatServiceClient::membershipName()} for help formatting this field.
Expand Down
12 changes: 6 additions & 6 deletions AppsChat/samples/V1/ChatServiceClient/get_message.php
Original file line number Diff line number Diff line change
Expand Up @@ -30,16 +30,16 @@

/**
* Returns details about a message.
* For an example, see [Read a
* message](https://developers.google.com/chat/api/guides/v1/messages/get).
* For an example, see [Get details about a
* message](https://developers.google.com/workspace/chat/get-messages).
*
* Requires
* [authentication](https://developers.google.com/chat/api/guides/auth).
* [authentication](https://developers.google.com/workspace/chat/authenticate-authorize).
* Supports
* [app
* authentication](https://developers.google.com/chat/api/guides/auth/service-accounts)
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
* and [user
* authentication](https://developers.google.com/chat/api/guides/auth/users).
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
*
* Note: Might return a message from a blocked member or space.
*
Expand All @@ -50,7 +50,7 @@
* If you've set a custom ID for your message, you can use the value from the
* `clientAssignedMessageId` field for `{message}`. For details, see [Name a
* message]
* (https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message). Please see
* (https://developers.google.com/workspace/chat/create-messages#name_a_created_message). Please see
* {@see ChatServiceClient::messageName()} for help formatting this field.
*/
function get_message_sample(string $formattedName): void
Expand Down
9 changes: 5 additions & 4 deletions AppsChat/samples/V1/ChatServiceClient/get_space.php
Original file line number Diff line number Diff line change
Expand Up @@ -30,15 +30,16 @@

/**
* Returns details about a space. For an example, see
* [Get a space](https://developers.google.com/chat/api/guides/v1/spaces/get).
* [Get details about a
* space](https://developers.google.com/workspace/chat/get-spaces).
*
* Requires
* [authentication](https://developers.google.com/chat/api/guides/auth).
* [authentication](https://developers.google.com/workspace/chat/authenticate-authorize).
* Supports
* [app
* authentication](https://developers.google.com/chat/api/guides/auth/service-accounts)
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
* and [user
* authentication](https://developers.google.com/chat/api/guides/auth/users).
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
*
* @param string $formattedName Resource name of the space, in the form "spaces/*".
*
Expand Down
18 changes: 9 additions & 9 deletions AppsChat/samples/V1/ChatServiceClient/list_memberships.php
Original file line number Diff line number Diff line change
Expand Up @@ -30,25 +30,25 @@
use Google\Apps\Chat\V1\Membership;

/**
* Lists memberships in a space. For an example, see [List
* memberships](https://developers.google.com/chat/api/guides/v1/members/list).
* Listing memberships with
* [app
* authentication](https://developers.google.com/chat/api/guides/auth/service-accounts)
* Lists memberships in a space. For an example, see [List users and Google
* Chat apps in a
* space](https://developers.google.com/workspace/chat/list-members). Listing
* memberships with [app
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
* lists memberships in spaces that the Chat app has
* access to, but excludes Chat app memberships,
* including its own. Listing memberships with
* [User
* authentication](https://developers.google.com/chat/api/guides/auth/users)
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
* lists memberships in spaces that the authenticated user has access to.
*
* Requires
* [authentication](https://developers.google.com/chat/api/guides/auth).
* [authentication](https://developers.google.com/workspace/chat/authenticate-authorize).
* Supports
* [app
* authentication](https://developers.google.com/chat/api/guides/auth/service-accounts)
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
* and [user
* authentication](https://developers.google.com/chat/api/guides/auth/users).
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
*
* @param string $formattedParent The resource name of the space for which to fetch a membership
* list.
Expand Down
2 changes: 1 addition & 1 deletion AppsChat/samples/V1/ChatServiceClient/list_messages.php
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@
* messages from blocked members and spaces. For an example, see
* [List messages](/chat/api/guides/v1/messages/list).
* Requires [user
* authentication](https://developers.google.com/chat/api/guides/auth/users).
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
*
* @param string $formattedParent The resource name of the space to list messages from.
*
Expand Down
6 changes: 3 additions & 3 deletions AppsChat/samples/V1/ChatServiceClient/list_reactions.php
Original file line number Diff line number Diff line change
Expand Up @@ -31,10 +31,10 @@

/**
* Lists reactions to a message. For an example, see
* [List
* reactions](https://developers.google.com/chat/api/guides/v1/reactions/list).
* [List reactions for a
* message](https://developers.google.com/workspace/chat/list-reactions).
* Requires [user
* authentication](https://developers.google.com/chat/api/guides/auth/users).
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
*
* @param string $formattedParent The message users reacted to.
*
Expand Down
8 changes: 4 additions & 4 deletions AppsChat/samples/V1/ChatServiceClient/list_spaces.php
Original file line number Diff line number Diff line change
Expand Up @@ -33,15 +33,15 @@
* Lists spaces the caller is a member of. Group chats and DMs aren't listed
* until the first message is sent. For an example, see
* [List
* spaces](https://developers.google.com/chat/api/guides/v1/spaces/list).
* spaces](https://developers.google.com/workspace/chat/list-spaces).
*
* Requires
* [authentication](https://developers.google.com/chat/api/guides/auth).
* [authentication](https://developers.google.com/workspace/chat/authenticate-authorize).
* Supports
* [app
* authentication](https://developers.google.com/chat/api/guides/auth/service-accounts)
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
* and [user
* authentication](https://developers.google.com/chat/api/guides/auth/users).
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
*
* Lists spaces visible to the caller or authenticated user. Group chats
* and DMs aren't listed until the first message is sent.
Expand Down
Loading

0 comments on commit 7096439

Please sign in to comment.