You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: api/openapi.yaml
+25-38Lines changed: 25 additions & 38 deletions
Original file line number
Diff line number
Diff line change
@@ -4390,23 +4390,35 @@ paths:
4390
4390
- application/json
4391
4391
/v1/connect/googlebusiness/locations:
4392
4392
get:
4393
-
description: For headless flows. Returns the list of GBP locations the user
4394
-
can manage. Use X-Connect-Token if connecting via API key.
4393
+
description: |
4394
+
For headless flows. Returns the list of GBP locations the user can manage. Use pendingDataToken (from the OAuth callback redirect) to list locations without consuming the token, so it remains available for select-location. Use X-Connect-Token header if connecting via API key.
4395
4395
operationId: listGoogleBusinessLocations
4396
4396
parameters:
4397
-
- description: Profile ID from your connection flow
4397
+
- description: Profile ID from your connection flow. Required for auth validation
4398
+
when provided.
4398
4399
explode: true
4399
4400
in: query
4400
4401
name: profileId
4401
-
required: true
4402
+
required: false
4402
4403
schema:
4403
4404
type: string
4404
4405
style: form
4405
-
- description: Temporary Google access token from the OAuth callback redirect
4406
+
- description: Token from the OAuth callback redirect. Preferred over tempToken
4407
+
because it preserves server-side token storage. One of pendingDataToken
4408
+
or tempToken is required.
4409
+
explode: true
4410
+
in: query
4411
+
name: pendingDataToken
4412
+
required: false
4413
+
schema:
4414
+
type: string
4415
+
style: form
4416
+
- description: Legacy. Direct Google access token. Use pendingDataToken instead
4417
+
when available.
4406
4418
explode: true
4407
4419
in: query
4408
4420
name: tempToken
4409
-
required: true
4421
+
required: false
4410
4422
schema:
4411
4423
type: string
4412
4424
style: form
@@ -4446,23 +4458,16 @@ paths:
4446
4458
- application/json
4447
4459
/v1/connect/googlebusiness/select-location:
4448
4460
post:
4449
-
description: Complete the headless flow by saving the user's selected GBP location.
4450
-
Include userProfile from the OAuth redirect (contains refresh token). Use
4451
-
X-Connect-Token if connecting via API key.
4461
+
description: |
4462
+
Complete the headless GBP flow by saving the user's selected location. The pendingDataToken is returned in your redirect URL after OAuth completes (step=select_location). Tokens and profile data are stored server-side, so only the pendingDataToken is needed here. Use X-Connect-Token header if connecting via API key.
For headless flows. Returns the list of GBP locations the user can manage. Use X-Connect-Token if connecting via API key.
2516
+
For headless flows. Returns the list of GBP locations the user can manage. Use pendingDataToken (from the OAuth callback redirect) to list locations without consuming the token, so it remains available for select-location. Use X-Connect-Token header if connecting via API key.
String profileId ="profileId_example"; // String | Profile ID from your connection flow
2546
-
String tempToken ="tempToken_example"; // String | Temporary Google access token from the OAuth callback redirect
2545
+
String profileId ="profileId_example"; // String | Profile ID from your connection flow. Required for auth validation when provided.
2546
+
String pendingDataToken ="pendingDataToken_example"; // String | Token from the OAuth callback redirect. Preferred over tempToken because it preserves server-side token storage. One of pendingDataToken or tempToken is required.
2547
+
String tempToken ="tempToken_example"; // String | Legacy. Direct Google access token. Use pendingDataToken instead when available.
2547
2548
try {
2548
-
ListGoogleBusinessLocations200Response result = apiInstance.listGoogleBusinessLocations(profileId, tempToken);
2549
+
ListGoogleBusinessLocations200Response result = apiInstance.listGoogleBusinessLocations(profileId, pendingDataToken, tempToken);
2549
2550
System.out.println(result);
2550
2551
} catch (ApiException e) {
2551
2552
System.err.println("Exception when calling ConnectApi#listGoogleBusinessLocations");
|**profileId**|**String**| Profile ID from your connection flow ||
2567
-
|**tempToken**|**String**| Temporary Google access token from the OAuth callback redirect ||
2567
+
|**profileId**|**String**| Profile ID from your connection flow. Required for auth validation when provided. |[optional]|
2568
+
|**pendingDataToken**|**String**| Token from the OAuth callback redirect. Preferred over tempToken because it preserves server-side token storage. One of pendingDataToken or tempToken is required. |[optional]|
2569
+
|**tempToken**|**String**| Legacy. Direct Google access token. Use pendingDataToken instead when available. |[optional]|
For headless flows. Returns the list of GBP locations the user can manage. Use X-Connect-Token if connecting via API key.
2599
+
For headless flows. Returns the list of GBP locations the user can manage. Use pendingDataToken (from the OAuth callback redirect) to list locations without consuming the token, so it remains available for select-location. Use X-Connect-Token header if connecting via API key.
String profileId ="profileId_example"; // String | Profile ID from your connection flow
2628
-
String tempToken ="tempToken_example"; // String | Temporary Google access token from the OAuth callback redirect
2629
+
String profileId ="profileId_example"; // String | Profile ID from your connection flow. Required for auth validation when provided.
2630
+
String pendingDataToken ="pendingDataToken_example"; // String | Token from the OAuth callback redirect. Preferred over tempToken because it preserves server-side token storage. One of pendingDataToken or tempToken is required.
2631
+
String tempToken ="tempToken_example"; // String | Legacy. Direct Google access token. Use pendingDataToken instead when available.
|**profileId**|**String**| Profile ID from your connection flow ||
2651
-
|**tempToken**|**String**| Temporary Google access token from the OAuth callback redirect ||
2653
+
|**profileId**|**String**| Profile ID from your connection flow. Required for auth validation when provided. |[optional]|
2654
+
|**pendingDataToken**|**String**| Token from the OAuth callback redirect. Preferred over tempToken because it preserves server-side token storage. One of pendingDataToken or tempToken is required. |[optional]|
2655
+
|**tempToken**|**String**| Legacy. Direct Google access token. Use pendingDataToken instead when available. |[optional]|
Complete the headless flow by saving the user's selected GBP location. Include userProfile from the OAuth redirect (contains refresh token). Use X-Connect-Token if connecting via API key.
3324
+
Complete the headless GBP flow by saving the user's selected location. The pendingDataToken is returned in your redirect URL after OAuth completes (step=select_location). Tokens and profile data are stored server-side, so only the pendingDataToken is needed here. Use X-Connect-Token header if connecting via API key.
3321
3325
3322
3326
### Example
3323
3327
@@ -3398,7 +3402,7 @@ public class Example {
3398
3402
3399
3403
Select GBP location
3400
3404
3401
-
Complete the headless flow by saving the user's selected GBP location. Include userProfile from the OAuth redirect (contains refresh token). Use X-Connect-Token if connecting via API key.
3405
+
Complete the headless GBP flow by saving the user's selected location. The pendingDataToken is returned in your redirect URL after OAuth completes (step=select_location). Tokens and profile data are stored server-side, so only the pendingDataToken is needed here. Use X-Connect-Token header if connecting via API key.
|**pendingDataToken**|**String**| Token from the OAuth callback redirect (pendingDataToken query param). Tokens and profile data are retrieved server-side from this token. ||
14
13
|**redirectUrl**|**URI**| Optional custom redirect URL to return to after selection |[optional]|
Copy file name to clipboardExpand all lines: openapi.yaml
+27-28Lines changed: 27 additions & 28 deletions
Original file line number
Diff line number
Diff line change
@@ -7209,18 +7209,27 @@ paths:
7209
7209
operationId: listGoogleBusinessLocations
7210
7210
tags: [Connect]
7211
7211
summary: List GBP locations
7212
-
description: For headless flows. Returns the list of GBP locations the user can manage. Use X-Connect-Token if connecting via API key.
7212
+
description: >
7213
+
For headless flows. Returns the list of GBP locations the user can manage.
7214
+
Use pendingDataToken (from the OAuth callback redirect) to list locations
7215
+
without consuming the token, so it remains available for select-location.
7216
+
Use X-Connect-Token header if connecting via API key.
7213
7217
parameters:
7214
7218
- name: profileId
7215
7219
in: query
7216
-
required: true
7220
+
required: false
7217
7221
schema: { type: string }
7218
-
description: Profile ID from your connection flow
7222
+
description: Profile ID from your connection flow. Required for auth validation when provided.
7223
+
- name: pendingDataToken
7224
+
in: query
7225
+
required: false
7226
+
schema: { type: string }
7227
+
description: Token from the OAuth callback redirect. Preferred over tempToken because it preserves server-side token storage. One of pendingDataToken or tempToken is required.
7219
7228
- name: tempToken
7220
7229
in: query
7221
-
required: true
7230
+
required: false
7222
7231
schema: { type: string }
7223
-
description: Temporary Google access token from the OAuth callback redirect
7232
+
description: Legacy. Direct Google access token. Use pendingDataToken instead when available.
7224
7233
security:
7225
7234
- bearerAuth: []
7226
7235
- connectToken: []
@@ -7267,47 +7276,37 @@ paths:
7267
7276
operationId: selectGoogleBusinessLocation
7268
7277
tags: [Connect]
7269
7278
summary: Select GBP location
7270
-
description: Complete the headless flow by saving the user's selected GBP location. Include userProfile from the OAuth redirect (contains refresh token). Use X-Connect-Token if connecting via API key.
7279
+
description: >
7280
+
Complete the headless GBP flow by saving the user's selected location.
7281
+
The pendingDataToken is returned in your redirect URL after OAuth completes
7282
+
(step=select_location). Tokens and profile data are stored server-side,
7283
+
so only the pendingDataToken is needed here. Use X-Connect-Token header
0 commit comments