Für die
Google Business Performance API gibt es eine
NEUE API-Methode, mit der sich mehrere „DailyMetrics“-Objekte in einer einzelnen Anfrage abrufen lassen.
Sehen Sie sich den
Zeitplan für die Einstellung und die Anleitung für die Migration von der reportInsights API-Methode Version 4 zur Google Business Profile Performance API an.
Method: chains.search
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Sucht die Kette anhand des Kettennamens.
HTTP-Anfrage
GET https://mybusiness.googleapis.com/v4/chains:search
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
| Parameter |
chainDisplayName |
string
Suchen Sie anhand des Namens nach einer Kette. Genaue/teilweise/unvollständige/ähnliche Suchanfragen werden unterstützt. Beispiele: „walmart“, „wal-mart“, „walmmmart“, „沃尔玛“
|
resultCount |
integer
Die maximale Anzahl übereinstimmender Ketten, die von dieser Abfrage zurückgegeben werden sollen. Der Standardwert ist 10. Der maximal mögliche Wert ist 500.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
Antwortnachricht für Locations.SearchChains
| JSON-Darstellung |
{
"chains": [
{
object (Chain)
}
]
} |
| Felder |
chains[] |
object (Chain)
Ketten, die mit dem abgefragten ChainDisplayName in SearchChainsRequest übereinstimmen. Wenn es keine Übereinstimmungen gibt, ist dieses Feld leer. Die Ergebnisse werden nach ihrer Relevanz aufgelistet.
|
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/plus.business.managehttps://www.googleapis.com/auth/business.manage
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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)."]]
