Google Business Profile एपीआई में
एपीआई का नया तरीका है. इसकी मदद से, एक ही एपीआई अनुरोध में कई `डेली मेट्रिक` फ़ेच की जा सकती हैं.
सेवा बंद होने का शेड्यूल देखें. साथ ही, v4 reportInsights API वाले तरीके से Google Business Profile की परफ़ॉर्मेंस एपीआई में माइग्रेट करने के बारे में निर्देश देखें.
Method: accounts.invitations.list
संग्रह की मदद से व्यवस्थित रहें
अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.
यह डायलॉग बॉक्स खास खाते के लिए ऐसे न्योतों की सूची बनाता है जिनकी मंज़ूरी बाकी है.
एचटीटीपी अनुरोध
GET https://mybusinessaccountmanagement.googleapis.com/v1/{parent=accounts/*}/invitations
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ पैरामीटर
पैरामीटर |
parent |
string
ज़रूरी है. उस खाते का नाम जिससे न्योतों की सूची ली जा रही है. accounts/{account_id}/invitations अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
|
क्वेरी पैरामीटर
पैरामीटर |
filter |
string
ज़रूरी नहीं. न्योते.target_type फ़ील्ड की मदद से, जवाब को फ़िल्टर किया जा सकता है.
|
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
AccessControl.List नंबर के लिए रिस्पॉन्स मैसेज.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
{
"invitations": [
{
object (Invitation )
}
]
} |
फ़ील्ड |
invitations[] |
object (Invitation )
उन न्योतों का कलेक्शन जो इस खाते के लिए अब तक स्वीकार नहीं किए गए हैं. यहां दिए गए न्योतों की संख्या 1,000 से ज़्यादा नहीं हो सकती.
|
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/business.manage
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
आमंत्रण
यह ऐसे न्योते को दिखाता है जिसे मंज़ूरी नहीं मिली है.
JSON के काेड में दिखाना |
{
"name": string,
"role": enum (AdminRole ),
"targetType": enum (TargetType ),
// Union field target can be only one of the following:
"targetAccount": {
object (Account )
},
"targetLocation": {
object (TargetLocation )
}
// End of list of possible types for union field target .
} |
फ़ील्ड |
name |
string
ज़रूरी है. न्योते के लिए संसाधन का नाम. accounts/{account_id}/invitations/{invitation_id} .
|
role |
enum (AdminRole )
सिर्फ़ आउटपुट के लिए. खाते पर न्योता पाने वाले व्यक्ति की भूमिका.
|
targetType |
enum (TargetType )
सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि रिस्पॉन्स में कौनसे टारगेट टाइप दिखाने चाहिए.
|
यूनियन फ़ील्ड target . इससे पता चलता है कि यह न्योता किस टारगेट के लिए है. target इनमें से सिर्फ़ एक हो सकता है: |
targetAccount |
object (Account )
यह न्योता, कम इस्तेमाल होने वाले खाते के लिए है.
|
targetLocation |
object (TargetLocation )
वह टारगेट जगह, जिसके लिए यह न्योता भेजा गया है.
|
TargetLocation
लंबित आमंत्रण के लिए लक्षित स्थान दिखाता है.
JSON के काेड में दिखाना |
{
"locationName": string,
"address": string
} |
फ़ील्ड |
locationName |
string
उस जगह का नाम जहां उपयोगकर्ता को न्योता भेजा गया है.
|
address |
string
उस जगह का पता जहां उपयोगकर्ता को न्योता भेजा गया है.
|
TargetType
न्योते का टारगेट किस तरह का है.
Enums |
TARGET_TYPE_UNSPECIFIED |
टारगेट टाइप की जानकारी न होने पर सेट करें. |
ACCOUNTS_ONLY |
केवल खाता प्रकार के लक्ष्यों के लिए आमंत्रण सूचीबद्ध करें. |
LOCATIONS_ONLY |
केवल स्थान प्रकार के लक्ष्यों के लिए आमंत्रणों की सूची बनाएं. |
जब तक कुछ अलग से न बताया जाए, तब तक इस पेज की सामग्री को 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\u003eLists pending invitations, up to 1000, for a specified Google My Business account.\u003c/p\u003e\n"],["\u003cp\u003eFilter results by invitation target type (Account or Location).\u003c/p\u003e\n"],["\u003cp\u003eResponse includes invitation details such as name, role, target type, and target information.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eInvitations can be targeted towards either a Google My Business account or a specific location.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.invitations.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListInvitationsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Invitation](#Invitation)\n - [JSON representation](#Invitation.SCHEMA_REPRESENTATION)\n- [TargetLocation](#TargetLocation)\n - [JSON representation](#TargetLocation.SCHEMA_REPRESENTATION)\n- [TargetType](#TargetType)\n\nLists pending invitations for the specified account.\n\n### HTTP request\n\n`GET https://mybusinessaccountmanagement.googleapis.com/v1/{parent=accounts/*}/invitations`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|---------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The name of the account from which the list of invitations is being retrieved. `accounts/{account_id}/invitations` |\n\n### Query parameters\n\n| Parameters ||\n|----------|----------------------------------------------------------------------------------------------|\n| `filter` | `string` Optional. Filtering the response is supported via the Invitation.target_type field. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for AccessControl.ListInvitations.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"invitations\": [ { object (/my-business/reference/accountmanagement/rest/v1/accounts.invitations/list#Invitation) } ] } ``` |\n\n| Fields ||\n|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `invitations[]` | `object (`[Invitation](/my-business/reference/accountmanagement/rest/v1/accounts.invitations/list#Invitation)`)` A collection of invitations that are pending for the account. The number of invitations listed here cannot exceed 1000. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\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).\n\nInvitation\n----------\n\nRepresents a pending invitation.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"role\": enum (/my-business/reference/accountmanagement/rest/v1/accounts.admins#Admin.AdminRole), \"targetType\": enum (/my-business/reference/accountmanagement/rest/v1/accounts.invitations/list#TargetType), // Union field `target` can be only one of the following: \"targetAccount\": { object (/my-business/reference/accountmanagement/rest/v1/accounts#Account) }, \"targetLocation\": { object (/my-business/reference/accountmanagement/rest/v1/accounts.invitations/list#TargetLocation) } // End of list of possible types for union field `target`. } ``` |\n\n| Fields ||\n|------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The resource name for the invitation. `accounts/{account_id}/invitations/{invitation_id}`. |\n| `role` | `enum (`[AdminRole](/my-business/reference/accountmanagement/rest/v1/accounts.admins#Admin.AdminRole)`)` Output only. The invited role on the account. |\n| `targetType` | `enum (`[TargetType](/my-business/reference/accountmanagement/rest/v1/accounts.invitations/list#TargetType)`)` Output only. Specifies which target types should appear in the response. |\n| Union field `target`. Indicates the target this invitation is for. `target` can be only one of the following: ||\n| `targetAccount` | `object (`[Account](/my-business/reference/accountmanagement/rest/v1/accounts#Account)`)` The sparsely populated account this invitation is for. |\n| `targetLocation` | `object (`[TargetLocation](/my-business/reference/accountmanagement/rest/v1/accounts.invitations/list#TargetLocation)`)` The target location this invitation is for. |\n\nTargetLocation\n--------------\n\nRepresents a target location for a pending invitation.\n\n| JSON representation |\n|-------------------------------------------------------|\n| ``` { \"locationName\": string, \"address\": string } ``` |\n\n| Fields ||\n|----------------|--------------------------------------------------------------------|\n| `locationName` | `string` The name of the location to which the user is invited. |\n| `address` | `string` The address of the location to which the user is invited. |\n\nTargetType\n----------\n\nThe type of target an invitation is for.\n\n| Enums ||\n|---------------------------|-----------------------------------------------------|\n| `TARGET_TYPE_UNSPECIFIED` | Set when target type is unspecified. |\n| `ACCOUNTS_ONLY` | List invitations only for targets of type Account. |\n| `LOCATIONS_ONLY` | List invitations only for targets of type Location. |"]]