Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

Commite303ef6

Browse files
docs: Improve documentation of attachment.proto, event_payload.proto and space.proto (#8815)
* docs: Improve documentation of attachment.proto, event_payload.proto and space.protofeat: Add app authorization support to space APIsfeat: Add accessory widget support for private messagesPiperOrigin-RevId: 845227338Source-Link:googleapis/googleapis@1a9d00bSource-Link:googleapis/googleapis-gen@ab1d025Copy-Tag: eyJwIjoiQXBwc0NoYXQvLk93bEJvdC55YW1sIiwiaCI6ImFiMWQwMjUwMDIyNGViN2VkYTQ3ZDIzNDY2ZTQwZDI1YzE3NmYyM2IifQ==* 🦉 Updates from OwlBot post-processorSeehttps://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md---------Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
1 parent29ff353 commite303ef6

File tree

13 files changed

+193
-85
lines changed

13 files changed

+193
-85
lines changed
0 Bytes
Binary file not shown.
59 Bytes
Binary file not shown.

‎AppsChat/samples/V1/ChatServiceClient/get_message.php‎

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -38,8 +38,18 @@
3838
*
3939
* - [App
4040
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
41-
* with the authorization scope:
42-
* - `https://www.googleapis.com/auth/chat.bot`
41+
* with one of the following authorization scopes:
42+
* - `https://www.googleapis.com/auth/chat.bot`: When using this
43+
* authorization scope, this method returns details about a message the
44+
* Chat app has access to, like direct messages and [slash
45+
* commands](https://developers.google.com/workspace/chat/slash-commands)
46+
* that invoke the Chat app.
47+
* - `https://www.googleapis.com/auth/chat.app.messages.readonly`
48+
* with [administrator
49+
* approval](https://support.google.com/a?p=chat-app-auth) (available in
50+
* [Developer Preview](https://developers.google.com/workspace/preview)).
51+
* When using this authentication scope,
52+
* this method returns details about a public message in a space.
4353
*
4454
* - [User
4555
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)

‎AppsChat/samples/V1/ChatServiceClient/get_space_event.php‎

Lines changed: 18 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -39,12 +39,26 @@
3939
* Note: The `permissionSettings` field is not returned in the Space
4040
* object of the Space event data for this request.
4141
*
42-
* Requires [user
43-
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
44-
* with an [authorization
42+
* Supports the following types of
43+
* [authentication](https://developers.google.com/workspace/chat/authenticate-authorize)
44+
* with an
45+
* [authorization
4546
* scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes)
4647
* appropriate for reading the requested data:
4748
*
49+
* - [App
50+
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
51+
* with [administrator
52+
* approval](https://support.google.com/a?p=chat-app-auth) in
53+
* [Developer Preview](https://developers.google.com/workspace/preview)
54+
* with one of the following authorization scopes:
55+
* - `https://www.googleapis.com/auth/chat.app.spaces`
56+
* - `https://www.googleapis.com/auth/chat.app.messages.readonly`
57+
* - `https://www.googleapis.com/auth/chat.app.memberships`
58+
*
59+
* - [User
60+
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
61+
* with one of the following authorization scopes:
4862
* - `https://www.googleapis.com/auth/chat.spaces.readonly`
4963
* - `https://www.googleapis.com/auth/chat.spaces`
5064
* - `https://www.googleapis.com/auth/chat.messages.readonly`
@@ -54,7 +68,7 @@
5468
* - `https://www.googleapis.com/auth/chat.memberships.readonly`
5569
* - `https://www.googleapis.com/auth/chat.memberships`
5670
*
57-
* To get an event, the authenticateduser must be a member of the space.
71+
* To get an event, the authenticatedcaller must be a member of the space.
5872
*
5973
* For an example, see [Get details about an
6074
* event from a Google Chat

‎AppsChat/samples/V1/ChatServiceClient/list_messages.php‎

Lines changed: 19 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -31,21 +31,34 @@
3131

3232
/**
3333
* Lists messages in a space that the caller is a member of, including
34-
* messages from blocked members and spaces. If you list messages from a
34+
* messages from blocked members and spaces. System messages, like those
35+
* announcing new space members, aren't included. If you list messages from a
3536
* space with no messages, the response is an empty object. When using a
3637
* REST/HTTP interface, the response contains an empty JSON object, `{}`.
3738
* For an example, see
3839
* [List
3940
* messages](https://developers.google.com/workspace/chat/api/guides/v1/messages/list).
4041
*
41-
* Requires [user
42-
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
43-
* with one of the following [authorization
44-
* scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
42+
* Supports the following types of
43+
* [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
44+
*
45+
* - [App
46+
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
47+
* with [administrator
48+
* approval](https://support.google.com/a?p=chat-app-auth) in
49+
* [Developer Preview](https://developers.google.com/workspace/preview)
50+
* with the authorization scope:
51+
* - `https://www.googleapis.com/auth/chat.app.messages.readonly`. When
52+
* using this authentication scope, this method only returns public
53+
* messages in a space. It doesn't include private messages.
4554
*
55+
* - [User
56+
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
57+
* with one of the following authorization scopes:
4658
* - `https://www.googleapis.com/auth/chat.messages.readonly`
4759
* - `https://www.googleapis.com/auth/chat.messages`
48-
* - `https://www.googleapis.com/auth/chat.import` (import mode spaces only)
60+
* - `https://www.googleapis.com/auth/chat.import` (import mode spaces
61+
* only)
4962
*
5063
* @param string $formattedParent The resource name of the space to list messages from.
5164
*

‎AppsChat/samples/V1/ChatServiceClient/list_space_events.php‎

Lines changed: 18 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -38,12 +38,26 @@
3838
* removed during the requested period, the event payload contains an empty
3939
* `Membership` resource.
4040
*
41-
* Requires [user
42-
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
43-
* with an [authorization
41+
* Supports the following types of
42+
* [authentication](https://developers.google.com/workspace/chat/authenticate-authorize)
43+
* with an
44+
* [authorization
4445
* scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes)
4546
* appropriate for reading the requested data:
4647
*
48+
* - [App
49+
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
50+
* with [administrator
51+
* approval](https://support.google.com/a?p=chat-app-auth) in
52+
* [Developer Preview](https://developers.google.com/workspace/preview)
53+
* with one of the following authorization scopes:
54+
* - `https://www.googleapis.com/auth/chat.app.spaces`
55+
* - `https://www.googleapis.com/auth/chat.app.messages.readonly`
56+
* - `https://www.googleapis.com/auth/chat.app.memberships`
57+
*
58+
* - [User
59+
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
60+
* with one of the following authorization scopes:
4761
* - `https://www.googleapis.com/auth/chat.spaces.readonly`
4862
* - `https://www.googleapis.com/auth/chat.spaces`
4963
* - `https://www.googleapis.com/auth/chat.messages.readonly`
@@ -53,7 +67,7 @@
5367
* - `https://www.googleapis.com/auth/chat.memberships.readonly`
5468
* - `https://www.googleapis.com/auth/chat.memberships`
5569
*
56-
* To list events, the authenticateduser must be a member of the space.
70+
* To list events, the authenticatedcaller must be a member of the space.
5771
*
5872
* For an example, see [List events from a Google Chat
5973
* space](https://developers.google.com/workspace/chat/list-space-events).

‎AppsChat/samples/V1/ChatServiceClient/search_spaces.php‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,9 @@
3131

3232
/**
3333
* Returns a list of spaces in a Google Workspace organization based on an
34-
* administrator's search.
34+
* administrator's search. In the request, set `use_admin_access` to `true`.
35+
* For an example, see [Search for and manage
36+
* spaces](https://developers.google.com/workspace/chat/search-manage-admin).
3537
*
3638
* Requires [user
3739
* authentication with administrator
@@ -42,8 +44,6 @@
4244
* - `https://www.googleapis.com/auth/chat.admin.spaces.readonly`
4345
* - `https://www.googleapis.com/auth/chat.admin.spaces`
4446
*
45-
* In the request, set `use_admin_access` to `true`.
46-
*
4747
* @param string $query A search query.
4848
*
4949
* You can search by using the following parameters:

‎AppsChat/src/Chat/V1/Attachment.php‎

Lines changed: 11 additions & 11 deletions
Some generated files are not rendered by default. Learn more aboutcustomizing how changed files appear on GitHub.

‎AppsChat/src/Chat/V1/Client/ChatServiceClient.php‎

Lines changed: 71 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -165,6 +165,7 @@ final class ChatServiceClient
165165
'https://www.googleapis.com/auth/chat.admin.spaces.readonly',
166166
'https://www.googleapis.com/auth/chat.app.delete',
167167
'https://www.googleapis.com/auth/chat.app.memberships',
168+
'https://www.googleapis.com/auth/chat.app.messages.readonly',
168169
'https://www.googleapis.com/auth/chat.app.spaces',
169170
'https://www.googleapis.com/auth/chat.app.spaces.create',
170171
'https://www.googleapis.com/auth/chat.bot',
@@ -1285,8 +1286,18 @@ public function getMembership(GetMembershipRequest $request, array $callOptions
12851286
*
12861287
* - [App
12871288
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
1288-
* with the authorization scope:
1289-
* - `https://www.googleapis.com/auth/chat.bot`
1289+
* with one of the following authorization scopes:
1290+
* - `https://www.googleapis.com/auth/chat.bot`: When using this
1291+
* authorization scope, this method returns details about a message the
1292+
* Chat app has access to, like direct messages and [slash
1293+
* commands](https://developers.google.com/workspace/chat/slash-commands)
1294+
* that invoke the Chat app.
1295+
* - `https://www.googleapis.com/auth/chat.app.messages.readonly`
1296+
* with [administrator
1297+
* approval](https://support.google.com/a?p=chat-app-auth) (available in
1298+
* [Developer Preview](https://developers.google.com/workspace/preview)).
1299+
* When using this authentication scope,
1300+
* this method returns details about a public message in a space.
12901301
*
12911302
* - [User
12921303
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
@@ -1387,12 +1398,26 @@ public function getSpace(GetSpaceRequest $request, array $callOptions = []): Spa
13871398
* Note: The `permissionSettings` field is not returned in the Space
13881399
* object of the Space event data for this request.
13891400
*
1390-
* Requires [user
1391-
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
1392-
* with an [authorization
1401+
* Supports the following types of
1402+
* [authentication](https://developers.google.com/workspace/chat/authenticate-authorize)
1403+
* with an
1404+
* [authorization
13931405
* scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes)
13941406
* appropriate for reading the requested data:
13951407
*
1408+
* - [App
1409+
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
1410+
* with [administrator
1411+
* approval](https://support.google.com/a?p=chat-app-auth) in
1412+
* [Developer Preview](https://developers.google.com/workspace/preview)
1413+
* with one of the following authorization scopes:
1414+
* - `https://www.googleapis.com/auth/chat.app.spaces`
1415+
* - `https://www.googleapis.com/auth/chat.app.messages.readonly`
1416+
* - `https://www.googleapis.com/auth/chat.app.memberships`
1417+
*
1418+
* - [User
1419+
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
1420+
* with one of the following authorization scopes:
13961421
* - `https://www.googleapis.com/auth/chat.spaces.readonly`
13971422
* - `https://www.googleapis.com/auth/chat.spaces`
13981423
* - `https://www.googleapis.com/auth/chat.messages.readonly`
@@ -1402,7 +1427,7 @@ public function getSpace(GetSpaceRequest $request, array $callOptions = []): Spa
14021427
* - `https://www.googleapis.com/auth/chat.memberships.readonly`
14031428
* - `https://www.googleapis.com/auth/chat.memberships`
14041429
*
1405-
* To get an event, the authenticateduser must be a member of the space.
1430+
* To get an event, the authenticatedcaller must be a member of the space.
14061431
*
14071432
* For an example, see [Get details about an
14081433
* event from a Google Chat
@@ -1645,21 +1670,34 @@ public function listMemberships(ListMembershipsRequest $request, array $callOpti
16451670

16461671
/**
16471672
* Lists messages in a space that the caller is a member of, including
1648-
* messages from blocked members and spaces. If you list messages from a
1673+
* messages from blocked members and spaces. System messages, like those
1674+
* announcing new space members, aren't included. If you list messages from a
16491675
* space with no messages, the response is an empty object. When using a
16501676
* REST/HTTP interface, the response contains an empty JSON object, `{}`.
16511677
* For an example, see
16521678
* [List
16531679
* messages](https://developers.google.com/workspace/chat/api/guides/v1/messages/list).
16541680
*
1655-
* Requires [user
1656-
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
1657-
* with one of the following [authorization
1658-
* scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
1681+
* Supports the following types of
1682+
* [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
1683+
*
1684+
* - [App
1685+
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
1686+
* with [administrator
1687+
* approval](https://support.google.com/a?p=chat-app-auth) in
1688+
* [Developer Preview](https://developers.google.com/workspace/preview)
1689+
* with the authorization scope:
1690+
* - `https://www.googleapis.com/auth/chat.app.messages.readonly`. When
1691+
* using this authentication scope, this method only returns public
1692+
* messages in a space. It doesn't include private messages.
16591693
*
1694+
* - [User
1695+
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
1696+
* with one of the following authorization scopes:
16601697
* - `https://www.googleapis.com/auth/chat.messages.readonly`
16611698
* - `https://www.googleapis.com/auth/chat.messages`
1662-
* - `https://www.googleapis.com/auth/chat.import` (import mode spaces only)
1699+
* - `https://www.googleapis.com/auth/chat.import` (import mode spaces
1700+
* only)
16631701
*
16641702
* The async variant is {@see ChatServiceClient::listMessagesAsync()} .
16651703
*
@@ -1731,12 +1769,26 @@ public function listReactions(ListReactionsRequest $request, array $callOptions
17311769
* removed during the requested period, the event payload contains an empty
17321770
* `Membership` resource.
17331771
*
1734-
* Requires [user
1735-
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
1736-
* with an [authorization
1772+
* Supports the following types of
1773+
* [authentication](https://developers.google.com/workspace/chat/authenticate-authorize)
1774+
* with an
1775+
* [authorization
17371776
* scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes)
17381777
* appropriate for reading the requested data:
17391778
*
1779+
* - [App
1780+
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
1781+
* with [administrator
1782+
* approval](https://support.google.com/a?p=chat-app-auth) in
1783+
* [Developer Preview](https://developers.google.com/workspace/preview)
1784+
* with one of the following authorization scopes:
1785+
* - `https://www.googleapis.com/auth/chat.app.spaces`
1786+
* - `https://www.googleapis.com/auth/chat.app.messages.readonly`
1787+
* - `https://www.googleapis.com/auth/chat.app.memberships`
1788+
*
1789+
* - [User
1790+
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
1791+
* with one of the following authorization scopes:
17401792
* - `https://www.googleapis.com/auth/chat.spaces.readonly`
17411793
* - `https://www.googleapis.com/auth/chat.spaces`
17421794
* - `https://www.googleapis.com/auth/chat.messages.readonly`
@@ -1746,7 +1798,7 @@ public function listReactions(ListReactionsRequest $request, array $callOptions
17461798
* - `https://www.googleapis.com/auth/chat.memberships.readonly`
17471799
* - `https://www.googleapis.com/auth/chat.memberships`
17481800
*
1749-
* To list events, the authenticateduser must be a member of the space.
1801+
* To list events, the authenticatedcaller must be a member of the space.
17501802
*
17511803
* For an example, see [List events from a Google Chat
17521804
* space](https://developers.google.com/workspace/chat/list-space-events).
@@ -1823,7 +1875,9 @@ public function listSpaces(ListSpacesRequest $request, array $callOptions = []):
18231875

18241876
/**
18251877
* Returns a list of spaces in a Google Workspace organization based on an
1826-
* administrator's search.
1878+
* administrator's search. In the request, set `use_admin_access` to `true`.
1879+
* For an example, see [Search for and manage
1880+
* spaces](https://developers.google.com/workspace/chat/search-manage-admin).
18271881
*
18281882
* Requires [user
18291883
* authentication with administrator
@@ -1834,8 +1888,6 @@ public function listSpaces(ListSpacesRequest $request, array $callOptions = []):
18341888
* - `https://www.googleapis.com/auth/chat.admin.spaces.readonly`
18351889
* - `https://www.googleapis.com/auth/chat.admin.spaces`
18361890
*
1837-
* In the request, set `use_admin_access` to `true`.
1838-
*
18391891
* The async variant is {@see ChatServiceClient::searchSpacesAsync()} .
18401892
*
18411893
* @example samples/V1/ChatServiceClient/search_spaces.php

0 commit comments

Comments
 (0)
[8]ページ先頭
©2009-2025 Movatter.jp