A API
Google Business Performance tem um
NOVO método de API que permite buscar várias "DailyMetrics" em uma única solicitação de API.
Confira a
programação de descontinuação e instruções para migrar do método de API reportInsights v4 para a API Google Business Profile Performance.
Method: chains.search
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Pesquisa a rede com base no nome dela.
Solicitação HTTP
GET https://mybusiness.googleapis.com/v4/chains:search
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de consulta
| Parâmetros |
chainDisplayName |
string
Pesquise uma rede pelo nome. Consultas exatas, parciais, difusas ou relacionadas são compatíveis. Exemplos: "walmart", "wal-mart", "walmmmart", "沃尔玛"
|
resultCount |
integer
O número máximo de cadeias correspondentes a serem retornadas dessa consulta. O padrão é 10. O valor máximo possível é 500.
|
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
Mensagem de resposta para Locations.SearchChains.
| Representação JSON |
{
"chains": [
{
object (Chain)
}
]
} |
| Campos |
chains[] |
object (Chain)
Cadeias que correspondem ao chainDisplayName consultado em SearchChainsRequest. Se não houver correspondências, este campo ficará vazio. Os resultados são listados em ordem de relevância.
|
Escopos de autorização
Requer um dos seguintes escopos do OAuth:
https://www.googleapis.com/auth/plus.business.managehttps://www.googleapis.com/auth/business.manage
Para mais informações, consulte a Visão geral do OAuth 2.0.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 2025-07-25 UTC."],[[["\u003cp\u003eThis document details how to search for a business chain using the \u003ccode\u003esearch\u003c/code\u003e endpoint and the \u003ccode\u003echainDisplayName\u003c/code\u003e query parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should be empty, and the response will include a list of chains matching the query, ranked by relevance.\u003c/p\u003e\n"],["\u003cp\u003eThe maximum number of results returned can be controlled using the \u003ccode\u003eresultCount\u003c/code\u003e query parameter, with a default of 10 and a maximum of 500.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required using either the \u003ccode\u003ehttps://www.googleapis.com/auth/plus.business.manage\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: chains.search\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.SearchChainsResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nSearches the chain based on chain name.\n\n### HTTP request\n\n`GET https://mybusiness.googleapis.com/v4/chains:search`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------|\n| `chainDisplayName` | `string` Search for a chain by its name. Exact/partial/fuzzy/related queries are supported. Examples: \"walmart\", \"wal-mart\", \"walmmmart\", \"沃尔玛\" |\n| `resultCount` | `integer` The maximum number of matched chains to return from this query. The default is 10. The maximum possible value is 500. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nResponse message for Locations.SearchChains.\n\n| JSON representation ||\n|------------------------------------------------------------------------------------|---|\n| ``` { \"chains\": [ { object (/my-business/reference/rest/v4/chains#Chain) } ] } ``` |\n\n| Fields ||\n|------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `chains[]` | `object (`[Chain](/my-business/reference/rest/v4/chains#Chain)`)` Chains that match the queried chainDisplayName in SearchChainsRequest. If there are no matches, this field will be empty. Results are listed in order of relevance. |\n\n### Authorization Scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/plus.business.manage`\n- `https://www.googleapis.com/auth/business.manage`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
