Google Business Profile एपीआई में
एपीआई का नया तरीका है. इसकी मदद से, एक ही एपीआई अनुरोध में कई `डेली मेट्रिक` फ़ेच की जा सकती हैं.
सेवा बंद होने का शेड्यूल देखें. साथ ही, v4 reportInsights API वाले तरीके से Google Business Profile की परफ़ॉर्मेंस एपीआई में माइग्रेट करने के बारे में निर्देश देखें.
Method: googleLocations.search
संग्रह की मदद से व्यवस्थित रहें
अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.
वे सभी संभावित जगहें खोजें जो तय किए गए अनुरोध से मेल खाती हैं.
एचटीटीपी अनुरोध
POST https://mybusiness.googleapis.com/v4/googleLocations:search
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:
| JSON के काेड में दिखाना |
{
"resultCount": integer,
// Union field search_query can be only one of the following:
"location": {
object (Location)
},
"query": string
// End of list of possible types for union field search_query.
} |
| फ़ील्ड |
resultCount |
integer
दिखाए जाने वाले मैच की संख्या. डिफ़ॉल्ट वैल्यू 3 है. इसमें ज़्यादा से ज़्यादा 10 वैल्यू हो सकती हैं. ध्यान दें कि ज़्यादा अनुरोध करने पर, इंतज़ार का समय बढ़ सकता है. पेजों को क्रम में नहीं लगाया जाता.
|
यूनियन फ़ील्ड search_query. खोज क्वेरी. इसे लोकेशन ऑब्जेक्ट या स्ट्रिंग क्वेरी के तौर पर दिया जा सकता है. search_query इनमें से सिर्फ़ एक हो सकता है: |
location |
object (Location)
खोजी जाने वाली जगह. अगर जगह की जानकारी दी गई है, तो उस जानकारी से मेल खाने वाली जगहें दिखेंगी.
|
query |
string
खोजने के लिए टेक्स्ट क्वेरी. किसी क्वेरी स्ट्रिंग से मिलने वाले खोज नतीजे, जगह की सटीक जानकारी देने की तुलना में कम सटीक होंगे. हालांकि, वे ज़्यादा सटीक मिलान दे सकते हैं.
|
जवाब का मुख्य भाग
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
GoogleLocations.SearchGoogleLocations के लिए जवाब मैसेज.
| JSON के काेड में दिखाना |
{
"googleLocations": [
{
object (GoogleLocation)
}
]
} |
| फ़ील्ड |
googleLocations[] |
object (GoogleLocation)
GoogleLocations का संग्रह जो बताए गए अनुरोध से संभावित मेल खाता है, जिसे सबसे ज़्यादा से लेकर सबसे कम सटीक के क्रम में सूची में रखा गया है.
|
अनुमति पाने के लिंक
इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:
https://www.googleapis.com/auth/plus.business.managehttps://www.googleapis.com/auth/business.manage
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
जब तक कुछ अलग से न बताया जाए, तब तक इस पेज की सामग्री को Creative Commons Attribution 4.0 License के तहत और कोड के नमूनों को Apache 2.0 License के तहत लाइसेंस मिला है. ज़्यादा जानकारी के लिए, Google Developers साइट नीतियां देखें. Oracle और/या इससे जुड़ी हुई कंपनियों का, Java एक रजिस्टर किया हुआ ट्रेडमार्क है.
आखिरी बार 2025-07-25 (UTC) को अपडेट किया गया.
[null,null,["आखिरी बार 2025-07-25 (UTC) को अपडेट किया गया."],[[["\u003cp\u003eSearch for Google Locations using either a specific location or a text-based query.\u003c/p\u003e\n"],["\u003cp\u003eSpecify the desired number of search results, with a maximum of 10.\u003c/p\u003e\n"],["\u003cp\u003eResults are returned in order of accuracy, with the most accurate matches appearing first.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authorization scopes for access.\u003c/p\u003e\n"]]],["The core content describes searching for Google locations via a `POST` request to `https://mybusiness.googleapis.com/v4/googleLocations:search`. The request body can include either a `location` object or a string `query` within the `search_query` field, plus an integer `resultCount`. The response body contains an array of `googleLocations`, representing potential matches ranked by accuracy. Authorization requires either `plus.business.manage` or `business.manage` OAuth scopes.\n"],null,["# Method: googleLocations.search\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.SearchGoogleLocationsResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nSearch all of the possible locations that are a match to the specified request.\n\n### HTTP request\n\n`POST https://mybusiness.googleapis.com/v4/googleLocations:search`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation ||\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"resultCount\": integer, // Union field `search_query` can be only one of the following: \"location\": { object (/my-business/reference/rest/v4/accounts.locations#Location) }, \"query\": string // End of list of possible types for union field `search_query`. } ``` |\n\n| Fields ||\n|---------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| `resultCount` | `integer` The number of matches to return. The default value is 3, with a maximum of 10. Note that latency may increase if more are requested. There is no pagination. |\n| Union field `search_query`. Search query. This can be provided either as a location object or as a string query. `search_query` can be only one of the following: |||\n| `location` | `object (`[Location](/my-business/reference/rest/v4/accounts.locations#Location)`)` Location to search for. If provided, will find locations which match the provided location details. |\n| `query` | `string` Text query to search for. The search results from a query string will be less accurate than if providing an exact location, but can provide more inexact matches. |\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nResponse message for GoogleLocations.SearchGoogleLocations.\n\n| JSON representation ||\n|---------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"googleLocations\": [ { object (/my-business/reference/rest/v4/googleLocations#GoogleLocation) } ] } ``` |\n\n| Fields ||\n|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `googleLocations[]` | `object (`[GoogleLocation](/my-business/reference/rest/v4/googleLocations#GoogleLocation)`)` A collection of GoogleLocations that are potential matches to the specified request, listed in order from most to least accuracy. |\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)."]]
