Skip to content

Commit e29c345

Browse files
chore: [AppsChat] update protobuf to 33.2 and rules_python to 1.6.0 (#9441)
* chore: update protobuf to 33.2 and rules_python to 1.6.0 PiperOrigin-RevId: 960369644 Source-Link: googleapis/googleapis@fc62df0 Source-Link: googleapis/googleapis-gen@80c5936 Copy-Tag: eyJwIjoiQXBwc0NoYXQvLk93bEJvdC55YW1sIiwiaCI6IjgwYzU5MzY4ZjZiOGM5MWZjZjU1ZTlmOTM3NTE5MjAzYjQ1YzIyZjMifQ== feat: add internal tag to generated $serviceScopes property fix: avoid passing null as an array offset in resumeOperation PiperOrigin-RevId: 960012253 Source-Link: googleapis/googleapis@19cec06 Source-Link: googleapis/googleapis-gen@855c2ce Copy-Tag: eyJwIjoiQXBwc0NoYXQvLk93bEJvdC55YW1sIiwiaCI6Ijg1NWMyY2VmZTk1ZmQxMmM5ZDNiMmM2ODQ5MDM3ZDJkOTc2OWU0NTYifQ== feat: update Compute v1 to revision 20260722 docs: update various comments PiperOrigin-RevId: 958583027 docs: Update copyright year PiperOrigin-RevId: 958631646 feat: add Tool.ExaAiSearch to Vertex AI v1beta1 Adds `Tool.ExaAiSearch` (with `api_key` and `custom_configs`) and the `Tool.exa_ai_search` field, letting callers ground model responses on Exa.ai web search results. PiperOrigin-RevId: 959032917 feat: add Tool.ExaAiSearch to Vertex AI v1 Adds `Tool.ExaAiSearch` (with `api_key` and `custom_configs`) and the `Tool.exa_ai_search` field, letting callers ground model responses on Exa.ai web search results. PiperOrigin-RevId: 959033171 feat: Allow users to search for spaces without requiring admin privileges docs: A comment for method `SearchSpaces` in service `ChatService` is changed docs: A comment for field `use_admin_access` in message `.google.chat.v1.SearchSpacesRequest` is changed docs: A comment for field `query` in message `.google.chat.v1.SearchSpacesRequest` is changed docs: A comment for field `order_by` in message `.google.chat.v1.SearchSpacesRequest` is changed docs: A comment for field `spaces` in message `.google.chat.v1.SearchSpacesResponse` is changed PiperOrigin-RevId: 959066237 fix(deps): Update the Java code generator (gapic-generator-java) to v2.75.0 PiperOrigin-RevId: 959793430 chore: Update Ruby generator to latest (v0.51.1) PiperOrigin-RevId: 959902593 Source-Link: googleapis/googleapis@2314177 Source-Link: googleapis/googleapis-gen@8e76ccf Copy-Tag: eyJwIjoiQXBwc0NoYXQvLk93bEJvdC55YW1sIiwiaCI6IjhlNzZjY2Y0NWRkZjZlNTQ4YWRkYTMzMTM5YWM2MjdjZmQ3Y2I5MjQifQ== * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md --------- Co-authored-by: Owl Bot
1 parent ad107ce commit e29c345

8 files changed

Lines changed: 334 additions & 58 deletions

File tree

‎AppsChat/metadata/Chat/V1/Space.php‎

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

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

Lines changed: 47 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -30,23 +30,35 @@
3030
use Google\Apps\Chat\V1\Space;
3131

3232
/**
33-
* Returns a list of spaces in a Google Workspace organization based on an
34-
* administrator's search. In the request, set `use_admin_access` to `true`.
35-
* For an example, see [Search for and manage
33+
* Returns a list of spaces in a Google Workspace organization. For an
34+
* example, see [Search for and manage
3635
* spaces](https://developers.google.com/workspace/chat/search-manage-admin).
3736
*
38-
* Requires [user
37+
* When `use_admin_access` is set to `false`, the results are limited to
38+
* spaces where the calling user is a joined member. To search with
39+
* administrator privileges, set `use_admin_access` to `true`.
40+
*
41+
* Supports the following types of
42+
* [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
43+
*
44+
* - [User
45+
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
46+
* with one of the following authorization scopes:
47+
* - `https://www.googleapis.com/auth/chat.spaces.readonly`
48+
* - `https://www.googleapis.com/auth/chat.spaces`
49+
*
50+
* - [User
3951
* authentication with administrator
4052
* privileges](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user#admin-privileges)
4153
* and one of the following [authorization
4254
* scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
43-
*
4455
* - `https://www.googleapis.com/auth/chat.admin.spaces.readonly`
4556
* - `https://www.googleapis.com/auth/chat.admin.spaces`
4657
*
4758
* @param string $query A search query.
4859
*
49-
* You can search by using the following parameters:
60+
* You can search by using the following parameters when `useAdminAccess`
61+
* is set to `true`:
5062
*
5163
* - `create_time`
5264
* - `customer`
@@ -56,18 +68,27 @@
5668
* - `space_history_state`
5769
* - `space_type`
5870
*
71+
* When `useAdminAccess` is set to `false`:
72+
*
73+
* - `display_name`
74+
* - `external_user_allowed`
75+
* - `space_type`
76+
*
5977
* `create_time` and `last_active_time` accept a timestamp in
6078
* [RFC-3339](https://www.rfc-editor.org/rfc/rfc3339) format and the supported
6179
* comparison operators are: `=`, `<`, `>`, `<=`, `>=`.
6280
*
63-
* `customer` is required and is used to indicate which customer
64-
* to fetch spaces from. `customers/my_customer` is the only supported value.
81+
* `customer` is required when `useAdminAccess` is set to `true`, and is
82+
* used to indicate which customer to fetch spaces from.
83+
* `customers/my_customer` is the only supported value.
6584
*
6685
* `display_name` only accepts the `HAS` (`:`) operator. The text to
6786
* match is first tokenized into tokens and each token is prefix-matched
6887
* case-insensitively and independently as a substring anywhere in the space's
6988
* `display_name`. For example, `Fun Eve` matches `Fun event` or `The
70-
* evening was fun`, but not `notFun event` or `even`.
89+
* evening was fun`, but not `notFun event` or `even`. When `useAdminAccess`
90+
* is set to `false`, `display_name` is required to retrieve meaningful
91+
* results. Otherwise, the default behavior is to return an empty response.
7192
*
7293
* `external_user_allowed` accepts either `true` or `false`.
7394
*
@@ -90,7 +111,8 @@
90111
* < "2022-01-01T00:00:00+00:00" AND last_active_time >
91112
* "2023-01-01T00:00:00+00:00"`.
92113
*
93-
* The following example queries are valid:
114+
* The following example queries are valid when `useAdminAccess` is set to
115+
* `true`:
94116
*
95117
* ```
96118
* customer = "customers/my_customer" AND space_type = "SPACE"
@@ -112,6 +134,21 @@
112134
* "2020-01-01T00:00:00+00:00") AND (external_user_allowed = "true") AND
113135
* (space_history_state = "HISTORY_ON" OR space_history_state = "HISTORY_OFF")
114136
* ```
137+
*
138+
* The following example queries are valid when `useAdminAccess` is set to
139+
* `false`:
140+
*
141+
* ```
142+
* display_name:"Hello World" AND space_type = "SPACE"
143+
*
144+
* (display_name:"Hello" OR display_name:"Fun") AND space_type = "SPACE"
145+
*
146+
* (external_user_allowed = "true" AND space_type = "SPACE") // Returns an
147+
* empty response.
148+
*
149+
* (external_user_allowed = "true" AND display_name:"Hello" AND space_type =
150+
* "SPACE")
151+
* ```
115152
*/
116153
function search_spaces_sample(string $query): void
117154
{

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

Lines changed: 21 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -188,7 +188,11 @@ final class ChatServiceClient
188188
/** The name of the code generator, to be included in the agent header. */
189189
private const CODEGEN_NAME = 'gapic';
190190

191-
/** The default scopes required by the service. */
191+
/**
192+
* The default scopes required by the service.
193+
*
194+
* @internal
195+
*/
192196
public static $serviceScopes = [
193197
'https://www.googleapis.com/auth/chat.admin.delete',
194198
'https://www.googleapis.com/auth/chat.admin.memberships',
@@ -2452,17 +2456,28 @@ public function searchMessages(SearchMessagesRequest $request, array $callOption
24522456
}
24532457

24542458
/**
2455-
* Returns a list of spaces in a Google Workspace organization based on an
2456-
* administrator's search. In the request, set `use_admin_access` to `true`.
2457-
* For an example, see [Search for and manage
2459+
* Returns a list of spaces in a Google Workspace organization. For an
2460+
* example, see [Search for and manage
24582461
* spaces](https://developers.google.com/workspace/chat/search-manage-admin).
24592462
*
2460-
* Requires [user
2463+
* When `use_admin_access` is set to `false`, the results are limited to
2464+
* spaces where the calling user is a joined member. To search with
2465+
* administrator privileges, set `use_admin_access` to `true`.
2466+
*
2467+
* Supports the following types of
2468+
* [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):
2469+
*
2470+
* - [User
2471+
* authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
2472+
* with one of the following authorization scopes:
2473+
* - `https://www.googleapis.com/auth/chat.spaces.readonly`
2474+
* - `https://www.googleapis.com/auth/chat.spaces`
2475+
*
2476+
* - [User
24612477
* authentication with administrator
24622478
* privileges](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user#admin-privileges)
24632479
* and one of the following [authorization
24642480
* scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):
2465-
*
24662481
* - `https://www.googleapis.com/auth/chat.admin.spaces.readonly`
24672482
* - `https://www.googleapis.com/auth/chat.admin.spaces`
24682483
*

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

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)