Method: customers.suggestBrands

इस ग्राहक के प्रीफ़िक्स के आधार पर, मिलते-जुलते ब्रैंड की सूची दिखाने के लिए आरपीसी.

एचटीटीपी अनुरोध

POST https://googleads.googleapis.com/v15/customers/{customerId}:suggestBrands

यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
customerId

string

ज़रूरी है. ग्राहक का वह आईडी जिस पर ब्रैंड के सुझाव की कार्रवाई लागू करनी है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना 
{
  "selectedBrands": [
    string
  ],
  "brandPrefix": string
}
फ़ील्ड
selectedBrands[]

string

ज़रूरी नहीं. उन ब्रैंड के आईडी जिन्हें विज्ञापन देने वालों ने पहले ही चुना है. इसके जवाब में उन्हें शामिल नहीं किया जाएगा. ये ब्रैंड आईडी होने चाहिए, न कि ब्रैंड के नाम.
brandPrefix

string

ज़रूरी है. ब्रैंड के नाम का प्रीफ़िक्स.

जवाब का मुख्य भाग

BrandSuggestionService.SuggestBrands के लिए जवाब.

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

जेएसओएन के काेड में दिखाना 
{
  "brands": [
    {
      object (BrandSuggestion)
    }
  ]
}
फ़ील्ड
brands[]

object (BrandSuggestion)

दिए गए प्रीफ़िक्स के लिए, पुष्टि किए गए ब्रैंड के ब्रैंड के सुझाव जनरेट किए गए.

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

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

  • https://www.googleapis.com/auth/adwords

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

BrandSuggestion

ब्रैंड के सुझाव की जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "id": string,
  "name": string,
  "urls": [
    string
  ],
  "state": enum (BrandState)
}
फ़ील्ड
id

string

ब्रैंड का आईडी. यह पुष्टि किए गए/ग्लोबल स्कोप वाले ब्रैंड के लिए CKG MID होगा.
name

string

ब्रैंड का नाम.
urls[]

string

ऐसे यूआरएल जो ब्रैंड की खास पहचान करते हैं.
state

enum (BrandState)

ब्रैंड की मौजूदा स्थिति.

BrandState

ब्रैंड की अलग-अलग स्थितियों की गिनती.

Enums
UNSPECIFIED कोई मान तय नहीं किया गया है.
UNKNOWN इसका इस्तेमाल सिर्फ़ रिटर्न वैल्यू के लिए किया जाता है. इस वर्शन में ऐसी वैल्यू दिखाता है जिसकी जानकारी नहीं है.
ENABLED ब्रैंड की पुष्टि हो चुकी है और यह दुनिया भर में चुनने के लिए उपलब्ध है
DEPRECATED कारोबार की शर्तों के आधार पर, यह ब्रैंड पहले दुनिया भर में उपलब्ध था, लेकिन अब यह मान्य नहीं है
UNVERIFIED ब्रैंड की पुष्टि नहीं की गई है और यह ग्राहक के दायरे में है. हालांकि, इसे ग्राहक टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना) के लिए चुन सकता है (सिर्फ़ वह व्यक्ति जिसने इसके लिए अनुरोध किया हो)
APPROVED यह ग्राहक के स्कोप वाला ऐसा ब्रैंड था जिसकी पुष्टि नहीं की गई थी. इसे कारोबार ने मंज़ूरी मिल गई है और इसे ग्लोबल सूची में जोड़ दिया गया है. इसके बजाय, असाइन किए गए CKG MID का इस्तेमाल किया जाना चाहिए
CANCELLED यह ब्रैंड, खरीदार के स्कोप वाला (जिसकी पुष्टि नहीं हुई है) था, लेकिन ग्राहक ने अनुरोध को रद्द कर दिया था. साथ ही, यह ब्रैंड आईडी अब मान्य नहीं है
REJECTED यह ब्रैंड, खरीदार के स्कोप वाला (पुष्टि नहीं की गई) थी, लेकिन कारोबार की इंटरनल टीम ने अनुरोध को अस्वीकार कर दिया था. साथ ही, यह ब्रैंड आईडी अब मान्य नहीं है