openapi-directory
Version:
Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS
1 lines • 280 kB
JSON
{"openapi":"3.0.0","servers":[{"url":"https://mybusiness.googleapis.com/"}],"info":{"contact":{"name":"Google","url":"https://google.com","x-twitter":"youtube"},"description":"The Google My Business API provides an interface for managing business location information on Google.","license":{"name":"Creative Commons Attribution 3.0","url":"http://creativecommons.org/licenses/by/3.0/"},"termsOfService":"https://developers.google.com/terms/","title":"Google My Business API","version":"v4","x-apisguru-categories":["analytics","media","location"],"x-logo":{"url":"https://upload.wikimedia.org/wikipedia/commons/e/e1/YouTube_play_buttom_icon_%282013-2017%29.svg"},"x-origin":[{"format":"google","url":"https://developers.google.com/my-business/samples/mybusiness_google_rest_v4p9.json","version":"v1"}],"x-providerName":"googleapis.com","x-serviceName":"my-business"},"externalDocs":{"url":"https://developers.google.com/my-business/"},"tags":[{"name":"accounts"},{"name":"attributes"},{"name":"categories"},{"name":"chains"},{"name":"googleLocations"}],"paths":{"/v4/accounts":{"get":{"description":"Lists all of the accounts for the authenticated user. This includes all accounts that the user owns, as well as any accounts for which the user has management rights.","operationId":"mybusiness.accounts.list","parameters":[{"description":"A filter constraining the accounts to return. The response includes only entries that match the filter. If `filter` is empty, then no constraints are applied and all accounts (paginated) are retrieved for the requested account. For example, a request with the filter `type=USER_GROUP` will only return user groups.","in":"query","name":"filter","schema":{"type":"string"}},{"description":"The resource name of the account for which the list of directly accessible accounts is to be retrieved. This only makes sense for Organizations and User Groups. If empty, will return `ListAccounts` for the authenticated user.","in":"query","name":"name","schema":{"type":"string"}},{"description":"How many accounts to fetch per page. Default is 20, minimum is 2, and maximum page size is 20.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"If specified, the next page of accounts is retrieved. The `pageToken` is returned when a call to `accounts.list` returns more results than can fit into the requested page size.","in":"query","name":"pageToken","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListAccountsResponse"}}},"description":"Successful response"}},"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Creates an account with the specified name and type under the given parent. - Personal accounts and Organizations cannot be created. - User Groups cannot be created with a Personal account as primary owner. - Location Groups cannot be created with a primary owner of a Personal account if the Personal account is in an Organization. - Location Groups cannot own Location Groups. ","operationId":"mybusiness.accounts.create","parameters":[{"description":"The resource name of the account which will be the primary owner of the account being created. It should be of the form `accounts/{account_id}/`.","in":"query","name":"primaryOwner","schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Account"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Account"}}},"description":"Successful response"}},"tags":["accounts"]}},"/v4/attributes":{"get":{"description":"Returns the list of available attributes that would be available for a location with the given primary category and country.","operationId":"mybusiness.attributes.list","parameters":[{"description":"The primary category stable ID to find available attributes.","in":"query","name":"categoryId","schema":{"type":"string"}},{"description":"The ISO 3166-1 alpha-2 country code to find available attributes.","in":"query","name":"country","schema":{"type":"string"}},{"description":"The BCP 47 code of language to get attribute display names in. If this language is not available, they will be provided in English.","in":"query","name":"languageCode","schema":{"type":"string"}},{"description":"Resource name of the location to look up available attributes.","in":"query","name":"name","schema":{"type":"string"}},{"description":"How many attributes to include per page. Default is 200, minimum is 1.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"If specified, the next page of attribute metadata is retrieved. The `pageToken` is returned when a call to `attributes.list` returns more results than can fit into the requested page size.","in":"query","name":"pageToken","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListAttributeMetadataResponse"}}},"description":"Successful response"}},"tags":["attributes"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v4/categories":{"get":{"description":"Returns a list of business categories. Search will match the category name but not the category ID. *Note:* Search only matches the front of a category name (that is, 'food' may return 'Food Court' but not 'Fast Food Restaurant').","operationId":"mybusiness.categories.list","parameters":[{"description":"The BCP 47 code of language. If the language is not available, it will default to English.","in":"query","name":"languageCode","schema":{"type":"string"}},{"description":"How many categories to fetch per page. Default is 100, minimum is 1, and maximum page size is 100.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"If specified, the next page of categories will be fetched.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"The ISO 3166-1 alpha-2 country code.","in":"query","name":"regionCode","schema":{"type":"string"}},{"description":"Optional filter string from user.","in":"query","name":"searchTerm","schema":{"type":"string"}},{"description":"Optional. Specifies which parts to the Category resource should be returned in the response.","in":"query","name":"view","schema":{"enum":["CATEGORY_VIEW_UNSPECIFIED","BASIC","FULL"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListBusinessCategoriesResponse"}}},"description":"Successful response"}},"tags":["categories"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v4/categories:batchGet":{"get":{"description":"Returns a list of business categories for the provided language and GConcept ids.","operationId":"mybusiness.categories.batchGet","parameters":[{"description":"Required. At least one name must be set. The GConcept ids the localized category names should be returned for.","explode":true,"in":"query","name":"categoryIds","schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Required. The BCP 47 code of language that the category names should be returned in.","in":"query","name":"languageCode","schema":{"type":"string"}},{"description":"Optional. The ISO 3166-1 alpha-2 country code used to infer non-standard language.","in":"query","name":"regionCode","schema":{"type":"string"}},{"description":"Required. Specifies which parts to the Category resource should be returned in the response.","in":"query","name":"view","schema":{"enum":["CATEGORY_VIEW_UNSPECIFIED","BASIC","FULL"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchGetBusinessCategoriesResponse"}}},"description":"Successful response"}},"tags":["categories"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v4/chains:search":{"get":{"description":"Searches the chain based on chain name.","operationId":"mybusiness.chains.search","parameters":[{"description":"Search for a chain by its name. Exact/partial/fuzzy/related queries are supported. Examples: \"walmart\", \"wal-mart\", \"walmmmart\", \"沃尔玛\"","in":"query","name":"chainDisplayName","schema":{"type":"string"}},{"description":"The maximum number of matched chains to return from this query. The default is 10. The maximum possible value is 500.","in":"query","name":"resultCount","schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchChainsResponse"}}},"description":"Successful response"}},"tags":["chains"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v4/googleLocations:search":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Search all of the possible locations that are a match to the specified request.","operationId":"mybusiness.googleLocations.search","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchGoogleLocationsRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchGoogleLocationsResponse"}}},"description":"Successful response"}},"tags":["googleLocations"]}},"/v4/{name}":{"delete":{"description":"Deletes a specific question written by the current user.","operationId":"mybusiness.accounts.locations.questions.delete","parameters":[{"description":"The name of the question to delete.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Empty"}}},"description":"Successful response"}},"tags":["accounts"]},"get":{"description":"Gets the specified chain. Returns `NOT_FOUND` if the chain does not exist.","operationId":"mybusiness.chains.get","parameters":[{"description":"The chain's resource name, in the format `chains/{chain_place_id}`.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Chain"}}},"description":"Successful response"}},"tags":["chains"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"patch":{"description":"Updates a specific question written by the current user.","operationId":"mybusiness.accounts.locations.questions.patch","parameters":[{"description":"The name of the question to update.","in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"The specific fields to update. If no mask is specified, then this is treated as a full update and all editable fields are set to the values passed in.","in":"query","name":"updateMask","schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Question"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Question"}}},"description":"Successful response"}},"tags":["accounts"]},"put":{"description":"Sets the pubsub notification settings for the account informing Business Profile which topic to send pubsub notifications for: - New reviews for locations administered by the account. - Updated reviews for locations administered by the account. - New `GoogleUpdates` for locations administered by the account. An account will only have one notification settings resource, and only one pubsub topic can be set.","operationId":"mybusiness.accounts.updateNotifications","parameters":[{"description":"The notification settings resource name.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Notifications"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Notifications"}}},"description":"Successful response"}},"tags":["accounts"]}},"/v4/{name}/localPosts:reportInsights":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Returns insights for a set of local posts associated with a single listing. Which metrics and how they are reported are options specified in the request proto. *Note:* Insight reports are limited to 100 `local_post_names` per call.","operationId":"mybusiness.accounts.locations.localPosts.reportInsights","parameters":[{"description":"Required. The name of the location for which to fetch insights.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportLocalPostInsightsRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportLocalPostInsightsResponse"}}},"description":"Successful response"}},"tags":["accounts"]}},"/v4/{name}/locations:batchGet":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Gets all of the specified locations in the given account.","operationId":"mybusiness.accounts.locations.batchGet","parameters":[{"description":"The name of the account from which to fetch locations.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchGetLocationsRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchGetLocationsResponse"}}},"description":"Successful response"}},"tags":["accounts"]}},"/v4/{name}/locations:batchGetReviews":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Returns the paginated list of reviews for all specified locations. This operation is only valid if the specified locations are verified. *Note:* Reviews are limited to a batch size of 200 `location_names` per call.","operationId":"mybusiness.accounts.locations.batchGetReviews","parameters":[{"description":"The name of the account from which to retrieve a list of reviews across multiple locations.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchGetReviewsRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchGetReviewsResponse"}}},"description":"Successful response"}},"tags":["accounts"]}},"/v4/{name}/locations:reportInsights":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Returns a report containing insights on one or more metrics by location. *Note:* Insight reports are limited to a batch size of 10 `location_names` per call.","operationId":"mybusiness.accounts.locations.reportInsights","parameters":[{"description":"The account resource name.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportLocationInsightsRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportLocationInsightsResponse"}}},"description":"Successful response"}},"tags":["accounts"]}},"/v4/{name}/reply":{"delete":{"description":"Deletes the response to the specified review. This operation is only valid if the specified location is verified.","operationId":"mybusiness.accounts.locations.reviews.deleteReply","parameters":[{"description":"The name of the review reply to delete.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Empty"}}},"description":"Successful response"}},"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"put":{"description":"Updates the reply to the specified review. A reply is created if one does not exist. This operation is only valid if the specified location is verified.","operationId":"mybusiness.accounts.locations.reviews.updateReply","parameters":[{"description":"The name of the review to respond to.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewReply"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewReply"}}},"description":"Successful response"}},"tags":["accounts"]}},"/v4/{name}:accept":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Accepts the specified invitation.","operationId":"mybusiness.accounts.invitations.accept","parameters":[{"description":"The name of the invitation that is being accepted.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptInvitationRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Empty"}}},"description":"Successful response"}},"tags":["accounts"]}},"/v4/{name}:associate":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Associates a location to a place ID. Any previous association is overwritten. This operation is only valid if the location is unverified. The association must be valid, that is, it appears in the list of `FindMatchingLocations`.","operationId":"mybusiness.accounts.locations.associate","parameters":[{"description":"The resource name of the location to associate.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssociateLocationRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Empty"}}},"description":"Successful response"}},"tags":["accounts"]}},"/v4/{name}:clearAssociation":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Clears an association between a location and its place ID. This operation is only valid if the location is unverified.","operationId":"mybusiness.accounts.locations.clearAssociation","parameters":[{"description":"The resource name of the location to disassociate.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClearLocationAssociationRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Empty"}}},"description":"Successful response"}},"tags":["accounts"]}},"/v4/{name}:complete":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Completes a `PENDING` verification. It is only necessary for non `AUTO` verification methods. `AUTO` verification request is instantly `VERIFIED` upon creation.","operationId":"mybusiness.accounts.locations.verifications.complete","parameters":[{"description":"Resource name of the verification to complete.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompleteVerificationRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompleteVerificationResponse"}}},"description":"Successful response"}},"tags":["accounts"]}},"/v4/{name}:decline":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Declines the specified invitation.","operationId":"mybusiness.accounts.invitations.decline","parameters":[{"description":"The name of the account invitation that is being declined.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeclineInvitationRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Empty"}}},"description":"Successful response"}},"tags":["accounts"]}},"/v4/{name}:fetchVerificationOptions":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Reports all eligible verification options for a location in a specific language.","operationId":"mybusiness.accounts.locations.fetchVerificationOptions","parameters":[{"description":"Resource name of the location to verify.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FetchVerificationOptionsRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FetchVerificationOptionsResponse"}}},"description":"Successful response"}},"tags":["accounts"]}},"/v4/{name}:findMatches":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Finds all of the possible locations that are a match to the specified location. This operation is only valid if the location is unverified.","operationId":"mybusiness.accounts.locations.findMatches","parameters":[{"description":"The resource name of the location to find matches for.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindMatchingLocationsRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindMatchingLocationsResponse"}}},"description":"Successful response"}},"tags":["accounts"]}},"/v4/{name}:generateAccountNumber":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Generates an account number for this account. The account number is not provisioned when an account is created. Use this request to create an account number when it is required.","operationId":"mybusiness.accounts.generateAccountNumber","parameters":[{"description":"The name of the account to generate an account number for.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateAccountNumberRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Account"}}},"description":"Successful response"}},"tags":["accounts"]}},"/v4/{name}:getGoogleUpdated":{"get":{"description":"Returns the Google updated Lodging of a specific location.","operationId":"mybusiness.accounts.locations.lodging.getGoogleUpdated","parameters":[{"description":"Required. Google identifier for this location in the form: `accounts/{account_id}/locations/{location_id}/lodging`","in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"Optional. The specific fields to return. If no mask is specified, then it returns the full Lodging (same as \"*\"). Repeated field items cannot be individually specified.","in":"query","name":"readMask","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetGoogleUpdatedLodgingResponse"}}},"description":"Successful response"}},"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v4/{name}:googleUpdated":{"get":{"description":"Gets the Google-updated version of the specified location. Returns `NOT_FOUND` if the location does not exist.","operationId":"mybusiness.accounts.locations.getGoogleUpdated","parameters":[{"description":"The name of the location to fetch.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleUpdatedLocation"}}},"description":"Successful response"}},"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v4/{name}:recommendGoogleLocations":{"get":{"description":"List all the GoogleLocations that have been recommended to the specified Business Profile account. Recommendations are provided for personal accounts and location groups only, requests for all other account types will result in an error. The recommendations for location groups are based on the locations in that group. The recommendations for personal accounts are based on all of the locations that the user has access to on Business Profile (which includes locations they can access through location groups), and is a superset of all recommendations generated for the user.","operationId":"mybusiness.accounts.listRecommendGoogleLocations","parameters":[{"description":"Name of the account resource to fetch recommended Google locations for.","in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"How many locations to fetch per page. Default is 25, minimum is 1, and maximum page size is 100.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"If specified, the next page of locations is retrieved.","in":"query","name":"pageToken","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListRecommendedGoogleLocationsResponse"}}},"description":"Successful response"}},"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v4/{name}:report":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Report a GoogleLocation.","operationId":"mybusiness.googleLocations.report","parameters":[{"description":"Resource name of a [GoogleLocation], in the format `googleLocations/{googleLocationId}`.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportGoogleLocationRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Empty"}}},"description":"Successful response"}},"tags":["googleLocations"]}},"/v4/{name}:transfer":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Moves a location from an account that the user owns to another account that the same user administers. The user must be an owner of the account the location is currently associated with and must also be at least a manager of the destination account. Returns the Location with its new resource name.","operationId":"mybusiness.accounts.locations.transfer","parameters":[{"description":"The name of the location to transfer.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransferLocationRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Location"}}},"description":"Successful response"}},"tags":["accounts"]}},"/v4/{name}:verify":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Starts the verification process for a location.","operationId":"mybusiness.accounts.locations.verify","parameters":[{"description":"Resource name of the location to verify.","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyLocationRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyLocationResponse"}}},"description":"Successful response"}},"tags":["accounts"]}},"/v4/{parent}/admins":{"get":{"description":"Lists all of the admins for the specified location.","operationId":"mybusiness.accounts.locations.admins.list","parameters":[{"description":"The name of the location to list admins of.","in":"path","name":"parent","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListLocationAdminsResponse"}}},"description":"Successful response"}},"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Invites the specified user to become an administrator for the specified location. The invitee must accept the invitation in order to be granted access to the location. See AcceptInvitation to programmatically accept an invitation.","operationId":"mybusiness.accounts.locations.admins.create","parameters":[{"description":"The resource name of the location this admin is created for.","in":"path","name":"parent","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Admin"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Admin"}}},"description":"Successful response"}},"tags":["accounts"]}},"/v4/{parent}/answers":{"get":{"description":"Returns the paginated list of answers for a specified question.","operationId":"mybusiness.accounts.locations.questions.answers.list","parameters":[{"description":"The name of the question to fetch answers for.","in":"path","name":"parent","required":true,"schema":{"type":"string"}},{"description":"The order to return the answers. Valid options include 'update_time desc' and 'upvote_count desc', which will return the answers sorted descendingly by the requested field. The default sort order is 'update_time desc'.","in":"query","name":"orderBy","schema":{"type":"string"}},{"description":"How many answers to fetch per page. The default and maximum `page_size` values are 10.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"If specified, the next page of answers is retrieved.","in":"query","name":"pageToken","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListAnswersResponse"}}},"description":"Successful response"}},"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v4/{parent}/answers:delete":{"delete":{"description":"Deletes the answer written by the current user to a question.","operationId":"mybusiness.accounts.locations.questions.answers.delete","parameters":[{"description":"The name of the question to delete an answer for.","in":"path","name":"parent","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Empty"}}},"description":"Successful response"}},"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v4/{parent}/answers:upsert":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Creates an answer or updates the existing answer written by the user for the specified question. A user can only create one answer per question.","operationId":"mybusiness.accounts.locations.questions.answers.upsert","parameters":[{"description":"The name of the question to write an answer for.","in":"path","name":"parent","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpsertAnswerRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}}},"description":"Successful response"}},"tags":["accounts"]}},"/v4/{parent}/insuranceNetworks":{"get":{"description":"Returns a list of all insurance networks supported by Google.","operationId":"mybusiness.accounts.locations.insuranceNetworks.list","parameters":[{"description":"Required. The name of the location whose insurance networks will be listed. The name is in the form: accounts/{account_id}/locations/{location_id}","in":"path","name":"parent","required":true,"schema":{"type":"string"}},{"description":"Optional. The BCP 47 code for the language. If a language code is not provided, it defaults to English. Right now only 'en' is supported.","in":"query","name":"languageCode","schema":{"type":"string"}},{"description":"How many insurance networks to return per page. The default value is 5000. Maximum page size is 10000.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"If specified, returns the next page of insurance networks.","in":"query","name":"pageToken","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListInsuranceNetworksResponse"}}},"description":"Successful response"}},"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v4/{parent}/invitations":{"get":{"description":"Lists pending invitations for the specified account.","operationId":"mybusiness.accounts.invitations.list","parameters":[{"description":"The name of the account from which the list of invitations is being retrieved.","in":"path","name":"parent","required":true,"schema":{"type":"string"}},{"description":"Specifies which target types should appear in the response.","in":"query","name":"targetType","schema":{"enum":["ALL","ACCOUNTS_ONLY","LOCATIONS_ONLY"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListInvitationsResponse"}}},"description":"Successful response"}},"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v4/{parent}/localPosts":{"get":{"description":"Returns a list of local posts associated with a location.","operationId":"mybusiness.accounts.locations.localPosts.list","parameters":[{"description":"The name of the location whose local posts will be listed.","in":"path","name":"parent","required":true,"schema":{"type":"string"}},{"description":"How many local posts to return per page. Default of 20. The minimum is 1, and maximum page size is 100.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"If specified, returns the next page of local posts.","in":"query","name":"pageToken","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListLocalPostsResponse"}}},"description":"Successful response"}},"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Creates a new local post associated with the specified location, and returns it.","operationId":"mybusiness.accounts.locations.localPosts.create","parameters":[{"description":"The name of the location in which to create this local post.","in":"path","name":"parent","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocalPost"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocalPost"}}},"description":"Successful response"}},"tags":["accounts"]}},"/v4/{parent}/locations":{"get":{"description":"Lists the locations for the specified account.","operationId":"mybusiness.accounts.locations.list","parameters":[{"description":"The name of the account to fetch locations from. If the Account is of AccountType PERSONAL, only Locations that are directly owned by the Account are returned, otherwise it will return all accessible locations from the Account, either directly or indirectly.","in":"path","name":"parent","required":true,"schema":{"type":"string"}},{"description":"A filter constraining the locations to return. The response includes only entries that match the filter. If `filter` is empty, then constraints are applied and all locations (paginated) are retrieved for t