Google Business Profile एपीआई में एपीआई का नया तरीका है. इसकी मदद से, एक ही एपीआई अनुरोध में कई `डेली मेट्रिक` फ़ेच की जा सकती हैं.
सेवा बंद होने का शेड्यूल देखें. साथ ही, v4 reportInsights API वाले तरीके से Google Business Profile की परफ़ॉर्मेंस एपीआई में माइग्रेट करने के बारे में निर्देश देखें.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

Package google.mybusiness.placeactions.v1

इंडेक्स

PlaceActions (इंटरफ़ेस)
CreatePlaceActionLinkRequest (मैसेज)
DeletePlaceActionLinkRequest (मैसेज)
ErrorCode (enum)
GetPlaceActionLinkRequest (मैसेज)
ListPlaceActionLinksRequest (मैसेज)
ListPlaceActionLinksResponse (मैसेज)
ListPlaceActionTypeMetadataRequest (मैसेज)
ListPlaceActionTypeMetadataResponse (मैसेज)
PlaceActionLink (मैसेज)
PlaceActionLink.ProviderType (enum)
PlaceActionType (enum)
PlaceActionTypeMetadata (मैसेज)
UpdatePlaceActionLinkRequest (मैसेज)

PlaceActions

यह एपीआई, कारोबार की जगहों केplaceAction लिंक को मैनेज करने की सुविधा देता है.

CreatePlaceActionLink

CreatePlaceActionLink
`rpc CreatePlaceActionLink(CreatePlaceActionLinkRequest) returns (PlaceActionLink)` किसी जगह से जुड़ी कार्रवाई की कार्रवाई का लिंक बनाता है और उसे दिखाता है. अगर `parent`, `place_action_link.uri`, और `place_action_link.place_action_type`, पिछले अनुरोध से मेल खाते हैं, तो उसे डुप्लीकेट माना जाएगा. अनुमति देने के दायरे नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है: `https://www.googleapis.com/auth/business.manage` ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

rpc CreatePlaceActionLink(CreatePlaceActionLinkRequest) returns (PlaceActionLink)

किसी जगह से जुड़ी कार्रवाई की कार्रवाई का लिंक बनाता है और उसे दिखाता है. अगर parent, place_action_link.uri, और place_action_link.place_action_type, पिछले अनुरोध से मेल खाते हैं, तो उसे डुप्लीकेट माना जाएगा.

अनुमति देने के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

https://www.googleapis.com/auth/business.manage

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

DeletePlaceActionLink

DeletePlaceActionLink
`rpc DeletePlaceActionLink(DeletePlaceActionLinkRequest) returns (Empty)` किसी खास जगह से कार्रवाई करने का लिंक मिटाता है. अनुमति देने के दायरे नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है: `https://www.googleapis.com/auth/business.manage` ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

rpc DeletePlaceActionLink(DeletePlaceActionLinkRequest) returns (Empty)

किसी खास जगह से कार्रवाई करने का लिंक मिटाता है.

अनुमति देने के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

https://www.googleapis.com/auth/business.manage

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

GetPlaceActionLink

GetPlaceActionLink
`rpc GetPlaceActionLink(GetPlaceActionLinkRequest) returns (PlaceActionLink)` जगह से जुड़ी कार्रवाई का लिंक मिलता है. अनुमति देने के दायरे नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है: `https://www.googleapis.com/auth/business.manage` ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

rpc GetPlaceActionLink(GetPlaceActionLinkRequest) returns (PlaceActionLink)

जगह से जुड़ी कार्रवाई का लिंक मिलता है.

अनुमति देने के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

https://www.googleapis.com/auth/business.manage

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

ListPlaceActionLinks

ListPlaceActionLinks
`rpc ListPlaceActionLinks(ListPlaceActionLinksRequest) returns (ListPlaceActionLinksResponse)` किसी खास जगह के लिए कार्रवाई करने के लिंक की सूची बनाता है. अनुमति देने के दायरे नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है: `https://www.googleapis.com/auth/business.manage` ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

rpc ListPlaceActionLinks(ListPlaceActionLinksRequest) returns (ListPlaceActionLinksResponse)

किसी खास जगह के लिए कार्रवाई करने के लिंक की सूची बनाता है.

अनुमति देने के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

https://www.googleapis.com/auth/business.manage

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

ListPlaceActionTypeMetadata

rpc ListPlaceActionTypeMetadata(ListPlaceActionTypeMetadataRequest) returns (ListPlaceActionTypeMetadataResponse)

किसी जगह या देश के लिए, जगह के हिसाब से की जाने वाली कार्रवाइयों की सूची दिखाता है.

अनुमति देने के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

https://www.googleapis.com/auth/business.manage

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

UpdatePlaceActionLink

UpdatePlaceActionLink
`rpc UpdatePlaceActionLink(UpdatePlaceActionLinkRequest) returns (PlaceActionLink)` जगह से जुड़ी कार्रवाई के लिंक को अपडेट करता है और उसे दिखाता है. अनुमति देने के दायरे नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है: `https://www.googleapis.com/auth/business.manage` ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

rpc UpdatePlaceActionLink(UpdatePlaceActionLinkRequest) returns (PlaceActionLink)

जगह से जुड़ी कार्रवाई के लिंक को अपडेट करता है और उसे दिखाता है.

अनुमति देने के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

https://www.googleapis.com/auth/business.manage

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

CreatePlaceActionLinkRequest

प्लेसमेंट कार्रवाइयों के लिए अनुरोध के मैसेज.CreatePlaceActionLink.

फ़ील्ड

फ़ील्ड
`parent`	`string` ज़रूरी है. उस जगह के संसाधन का नाम जहां इस जगह से जुड़ी कार्रवाई का लिंक बनाना है. `locations/{location_id}`.
`place_action_link`	`PlaceActionLink` ज़रूरी है. कार्रवाई की जगह का लिंक बनाया जाना है.

parent

string

ज़रूरी है. उस जगह के संसाधन का नाम जहां इस जगह से जुड़ी कार्रवाई का लिंक बनाना है. locations/{location_id}.

place_action_link

PlaceActionLink

ज़रूरी है. कार्रवाई की जगह का लिंक बनाया जाना है.

DeletePlaceActionLinkRequest

प्लेसमेंट कार्रवाइयों के लिए अनुरोध का मैसेज.

फ़ील्ड

फ़ील्ड
`name`	`string` ज़रूरी है. जगह से जुड़ी कार्रवाई का लिंक, जिसे किसी जगह से हटाना है उसका संसाधन नाम.

name

string

ज़रूरी है. जगह से जुड़ी कार्रवाई का लिंक, जिसे किसी जगह से हटाना है उसका संसाधन नाम.

ErrorCode

अंदरूनी गड़बड़ियों के लिए गड़बड़ी कोड.

Enums
`ERROR_CODE_UNSPECIFIED`	अनजान गड़बड़ी कोड.
`UNVERIFIED_LOCATION`	जगह की पुष्टि नहीं हुई है.
`INVALID_LOCATION_CATEGORY`	जगह की कैटगरी, जगह से जुड़ी कार्रवाई के टाइप के लिए सही नहीं है. गड़बड़ी की वजह से होने वाली कार्रवाई का टाइप मेटाडेटा में दिखाया जाएगा. इसमें "place_action_type" स्ट्रिंग, कुंजी के तौर पर और `PlaceActionType` enum वैल्यू स्ट्रिंग, वैल्यू के तौर पर शामिल की जाएगी.
`INVALID_URL`	यूआरएल गलत/अमान्य है. गलत जगह कार्रवाई यूआरएल को मेटाडेटा में दिखाया जाएगा, जिसमें "url" स्ट्रिंग को कुंजी और यूआरएल को वैल्यू के तौर पर दिखाया जाएगा.
`URL_PROVIDER_NOT_ALLOWED`	यूआरएल में एक प्रोवाइडर है, जिसकी अनुमति नहीं है. जिस कार्रवाई की अनुमति नहीं है उसका यूआरएल मेटाडेटा में दिखाया जाएगा. इसमें स्ट्रिंग "url" कुंजी के तौर पर और यूआरएल को वैल्यू के तौर पर शामिल किया जाएगा.
`TOO_MANY_VALUES`	जगह से जुड़ी कार्रवाई के प्रकार के लिए बहुत सारी वैल्यू सेट की गई हैं. जिस टाइप के लिए सीमा पूरी हुई है वह मेटाडेटा में दिखाया जाएगा. इसमें "place_action_type" स्ट्रिंग, कुंजी के तौर पर और `PlaceActionType` enum वैल्यू स्ट्रिंग को वैल्यू के तौर पर शामिल किया जाएगा.
`DELETED_LINK`	अनुरोध किए गए जगह की कार्रवाई का लिंक मिटा दिया गया है. संबंधित यूआरएल को मेटाडेटा में दिखाया जाएगा, जिसमें स्ट्रिंग "url" कुंजी के तौर पर और यूआरएल को मान के तौर पर शामिल किया जाएगा.
`LINK_ALREADY_EXISTS`	अपडेट का अनुरोध किया जा रहा है, ताकि कार्रवाई के उसी लिंक को पहले से मौजूद यूआरएल में बदला जा सके और उसका यूआरएल, तय की गई जगह पर पहले से मौजूद हो.
`SCALABLE_DEEP_LINK_INVALID_MULTIPLICITY`	लिंक में शामिल डोमेन का इस्तेमाल पहले ही किया जा चुका है. साथ ही, हर प्लेसमेंट के लिए हर डोमेन में एक लिंक की सीमा तय होती है.
`LINK_DOES_NOT_EXIST`	एक ऐसा लिंक दिया गया है जो डेटाबेस में नहीं मिल सका.

GetPlaceActionLinkRequest

Plan Actions.GetPlaceActionLink के लिए मैसेज का अनुरोध करें.

फ़ील्ड

फ़ील्ड
`name`	`string` ज़रूरी है. फ़ेच करने के लिए कार्रवाई करने के लिंक का नाम.

name

string

ज़रूरी है. फ़ेच करने के लिए कार्रवाई करने के लिंक का नाम.

ListPlaceActionLinksRequest

प्लेसमेंट कार्रवाइयों.ListPlaceActionLinks के लिए अनुरोध वाला मैसेज. इसमें किसी जगह के लिए, कार्रवाई करने के लिंक को किसी खास क्रम में शामिल नहीं किया जाएगा. ऐसा हो सकता है कि आप उन लिंक को न दिखाएं जो हाल ही में (पिछले 24 घंटे के अंदर) बनाए गए हैं और जो दूसरे प्लैटफ़ॉर्म जैसे कि Google MyBusiness की वेबसाइट से बनाए गए हैं. 24 घंटे से पहले बनाया गया कोई भी लिंक, इस एपीआई का इस्तेमाल करके दिखेगा.

फ़ील्ड
`parent`	`string` ज़रूरी है. उस जगह का नाम जहां कार्रवाई करने के लिंक सूची में शामिल किए जाएंगे. `locations/{location_id}`.
`filter`	`string` ज़रूरी नहीं. एक फ़िल्टर, जो वापस आने के लिए जगह की कार्रवाई से जुड़े लिंक को रोकता है. जवाब में, फ़िल्टर से मैच करने वाली एंट्री शामिल होती हैं. हम सिर्फ़ इस फ़िल्टर के साथ काम करते हैं: 1. place_action_type=XYZ में XYZ एक मान्य “placeActionType होता है”.
`page_size`	`int32` ज़रूरी नहीं. हर पेज पर लौटाने के लिए, कार्रवाई के कितने लिंक हैं. डिफ़ॉल्ट वैल्यू 10. कम से कम एक वैल्यू होनी चाहिए.
`page_token`	`string` ज़रूरी नहीं. अगर बताया गया हो, तो कार्रवाई के लिंक का अगला पेज दिखाता है.

ListPlaceActionLinksResponse

प्लेस एक्शन के लिए जवाब में भेजा गया मैसेज.

फ़ील्ड

फ़ील्ड
`place_action_links[]`	`PlaceActionLink` कार्रवाई करने के लिंक की सूची दिखाई गई.
`next_page_token`	`string` अगर अनुरोध किए गए पेज के साइज़ से ज़्यादा जगह कार्रवाई के लिंक हैं, तो इस फ़ील्ड को एक टोकन से भर दिया जाता है, ताकि नतीजों का अगला पेज फ़ेच किया जा सके.

place_action_links[]

PlaceActionLink

कार्रवाई करने के लिंक की सूची दिखाई गई.

next_page_token

string

अगर अनुरोध किए गए पेज के साइज़ से ज़्यादा जगह कार्रवाई के लिंक हैं, तो इस फ़ील्ड को एक टोकन से भर दिया जाता है, ताकि नतीजों का अगला पेज फ़ेच किया जा सके.

ListPlaceActionTypeMetadataRequest

प्लेसमेंट कार्रवाइयों के लिए अनुरोध के मैसेज.ListPlaceActionTypeMetadata. नतीजे किसी खास क्रम में नहीं दिखाए जाएंगे.

फ़ील्ड
`language_code`	`string` ज़रूरी नहीं. डिसप्ले नेम पाने के लिए, भाषा का IETF BCP-47 कोड. अगर यह भाषा उपलब्ध नहीं है, तो इसे अंग्रेज़ी में उपलब्ध कराया जाएगा.
`page_size`	`int32` ज़रूरी नहीं. हर पेज पर कितनी तरह की कार्रवाई शामिल की जानी चाहिए. डिफ़ॉल्ट संख्या 10 और कम से कम 1 होती है.
`page_token`	`string` ज़रूरी नहीं. अगर तय किया गया है, तो जगह से जुड़ी कार्रवाई के प्रकार के मेटाडेटा का अगला पेज फिर से लाया जाता है. जब `placeActionTypeMetadata.list` को कॉल करने पर, अनुरोध किए गए पेज साइज़ से ज़्यादा नतीजे मिलते हैं, तब `pageToken` दिखाया जाता है.
`filter`	`string` ज़रूरी नहीं. एक फ़िल्टर, जो जगह की कार्रवाइयों के टाइप को सीमित करता है, ताकि उसका मेटाडेटा दिखाया जा सके. जवाब में, फ़िल्टर से मैच करने वाली एंट्री शामिल होती हैं. हम सिर्फ़ इन फ़िल्टर के साथ काम करते हैं: 1. location=XYZ जहां XYZ किसी जगह के संसाधन का नाम दिखाने वाली स्ट्रिंग होती है, जो `locations/{location_id}` फ़ॉर्मैट में होती है. 2. region_code=XYZ में उपलब्ध कार्रवाई टाइप खोजने के लिए, XYZ एक यूनिकोड CLDR क्षेत्र कोड होता है. अगर कोई फ़िल्टर नहीं दिया गया है, तो जगह पर की जाने वाली सभी कार्रवाइयां दिखेंगी.

ListPlaceActionTypeMetadataResponse

स्थान कार्रवाइयों.ListPlaceActionTypeMetadata के लिए जवाब का मैसेज.

फ़ील्ड

place_action_type_metadata[]

PlaceActionTypeMetadata

जगह पर की जाने वाली कार्रवाइयों के लिए उपलब्ध मेटाडेटा का कलेक्शन.

next_page_token

string

अगर कार्रवाई के टाइप की संख्या, अनुरोध किए गए पेज के साइज़ से ज़्यादा है, तो इस फ़ील्ड को एक टोकन से भर दिया जाएगा. ऐसा placeActionTypeMetadata.list के बाद किए जाने वाले कॉल पर अगले पेज को फ़ेच करने के लिए किया जाएगा. अगर कोई और नतीजा नहीं मिलता, तो जवाब में यह फ़ील्ड मौजूद नहीं होगा.

PlaceActionLink

कार्रवाई की जगह का लिंक और उसकी विशेषताएं दिखाता है.

फ़ील्ड
`name`	`string` ज़रूरी नहीं. संसाधन का नाम, `locations/{location_id}/placeActionLinks/{place_action_link_id}` फ़ॉर्मैट में. लिंक अपडेट करने और हटाने के लिए नाम वाले फ़ील्ड को UpdatePlaceActionLink और DeletePlaceActionLink के सिर्फ़ अनुरोधों पर ही माना जाएगा. हालांकि, इसे CreatePlaceActionLink अनुरोध में अनदेखा कर दिया जाएगा. यहां नया लिंक बनाने के बाद सर्वर, `place_action_link_id` को असाइन करेगा और रिस्पॉन्स के तौर पर दिखाया जाएगा.
`provider_type`	`ProviderType` सिर्फ़ आउटपुट के लिए. यह बताता है कि सेवा देने वाली कंपनी किस तरह की है.
`is_editable`	`bool` सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि क्लाइंट इस लिंक में बदलाव कर सकता है या नहीं.
`uri`	`string` ज़रूरी है. लिंक यूआरआई. अलग-अलग जगहों पर, अलग-अलग तरह की कार्रवाइयों के लिए, एक ही यूआरआई का फिर से इस्तेमाल किया जा सकता है. हालांकि, हर यूनीक कॉम्बिनेशन (यूरी, जगह के लिए कार्रवाई का टाइप, जगह) के लिए, सिर्फ़ एक जगह कार्रवाई करने का लिंक इस्तेमाल किया जा सकता है.
`place_action_type`	`PlaceActionType` ज़रूरी है. इस लिंक का इस्तेमाल करके, जगह से जुड़ी कार्रवाई की जानकारी.
`is_preferred`	`bool` ज़रूरी नहीं. व्यापारी/कंपनी/कारोबारी ने इस लिंक को इस्तेमाल करने का विकल्प चुना है या नहीं. किसी जगह पर, हर तरह की कार्रवाई के लिए सिर्फ़ एक लिंक को 'पसंदीदा' के तौर पर मार्क किया जा सकता है. अगर आने वाले समय में किया जाने वाला कोई अनुरोध, जगह से जुड़ी एक ही तरह की कार्रवाई के लिए किसी दूसरे लिंक को पसंदीदा के तौर पर मार्क करता है, तो मौजूदा पसंदीदा लिंक (अगर कोई है) अपनी प्राथमिकता खो देगा.
`create_time`	`Timestamp` सिर्फ़ आउटपुट के लिए. जगह की जानकारी से जुड़ी कार्रवाई का लिंक बनाए जाने का समय.
`update_time`	`Timestamp` सिर्फ़ आउटपुट के लिए. जगह की जानकारी से जुड़ी कार्रवाई के लिंक में आखिरी बार बदलाव किए जाने का समय.

ProviderType

लिंक देने वाली कंपनी का टाइप, सिर्फ़ पढ़ा जा सकता है.

Enums
`PROVIDER_TYPE_UNSPECIFIED`	जानकारी नहीं दी गई.
`MERCHANT`	पहले पक्ष के तौर पर काम करने वाली कंपनी, जैसे कि व्यापारी/कंपनी या व्यापारी/कंपनी की तरफ़ से कोई एजेंसी.
`AGGREGATOR_3P`	3P एग्रीगेटर, जैसे कि `Reserve with Google` पार्टनर.

PlaceActionType

लिंक का इस्तेमाल करके किस तरह की कार्रवाई की जा सकती है.

Enums
`PLACE_ACTION_TYPE_UNSPECIFIED`	जानकारी नहीं दी गई.
`APPOINTMENT`	कार्रवाई का टाइप, अपॉइंटमेंट बुक करना है.
`ONLINE_APPOINTMENT`	कार्रवाई का टाइप, ऑनलाइन अपॉइंटमेंट बुक करना है.
`DINING_RESERVATION`	कार्रवाई का मतलब डाइनिंग बुकिंग करना है.
`FOOD_ORDERING`	कार्रवाई का टाइप, खाना डिलीवर करने और/या घर ले जाने के लिए ऑर्डर करना है.
`FOOD_DELIVERY`	कार्रवाई का टाइप, खाना डिलीवर करने के लिए ऑर्डर करना है.
`FOOD_TAKEOUT`	कार्रवाई की मदद से, खाना पैक कराकर ले जाने की सुविधा है.
`SHOP_ONLINE`	कार्रवाई का मतलब शॉपिंग है. यह डिलीवरी और/या पिकअप की सुविधा हो सकती है.

PlaceActionTypeMetadata

जगह के लिए तय की गई कार्रवाइयों का मेटाडेटा.

फ़ील्ड

place_action_type

PlaceActionType

जगह की कार्रवाई का टाइप.

display_name

string

अगर एट्रिब्यूट उपलब्ध है, तो उसके लिए स्थानीय भाषा में लिखा गया डिसप्ले नेम. अगर ऐसा नहीं है, तो अंग्रेज़ी में डिसप्ले नेम.

UpdatePlaceActionLinkRequest

Places Actions.UpdatePlaceActionLink के लिए अनुरोध वाला मैसेज.

फ़ील्ड

फ़ील्ड
`place_action_link`	`PlaceActionLink` ज़रूरी है. अपडेट किया गया, कार्रवाई करने का लिंक.
`update_mask`	`FieldMask` ज़रूरी है. वे फ़ील्ड जिन्हें अपडेट करना है. सिर्फ़ `uri`, `place_action_type`, और `is_preferred` फ़ील्ड में बदलाव किया जा सकता है. अगर अपडेट किया गया लिंक पहले से ही `place_action_type` और `uri` वाले एक ही जगह पर मौजूद है, तो `ALREADY_EXISTS` गड़बड़ी दिखेगी.

place_action_link

PlaceActionLink

ज़रूरी है. अपडेट किया गया, कार्रवाई करने का लिंक.

update_mask

FieldMask

ज़रूरी है. वे फ़ील्ड जिन्हें अपडेट करना है. सिर्फ़ uri, place_action_type, और is_preferred फ़ील्ड में बदलाव किया जा सकता है. अगर अपडेट किया गया लिंक पहले से ही place_action_type और uri वाले एक ही जगह पर मौजूद है, तो ALREADY_EXISTS गड़बड़ी दिखेगी.