Method: customers.keywordPlanAdGroups.mutate

कीवर्ड प्लान वाले विज्ञापन ग्रुप बनाता है, अपडेट करता है या हटाता है. ऑपरेशन की स्थितियां दिखाई जाती हैं.

थ्रॉ की गई गड़बड़ियों की सूची: AuthenticationError AuthorizationError DatabaseError FieldError FieldMaskError HeaderError InternalError KeywordPlanAdGroupError KeywordPlanError MutateError NewResourceCreationErrorQuotaErrorRequestErrorResourceCountLimitExceededError

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

POST https://googleads.googleapis.com/v16/customers/{customerId}/keywordPlanAdGroups:mutate

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

पाथ पैरामीटर

पैरामीटर
customerId

string

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

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

अनुरोध के मुख्य भाग में, नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:

JSON के काेड में दिखाना 
{
  "operations": [
    {
      object (KeywordPlanAdGroupOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
फ़ील्ड
operations[]

object (KeywordPlanAdGroupOperation)

ज़रूरी है. कीवर्ड प्लान के अलग-अलग विज्ञापन ग्रुप पर करने के लिए कार्रवाइयों की सूची.
partialFailure

boolean

अगर यह वैल्यू 'सही' है, तो सही कार्रवाइयां पूरी हो जाएंगी और अमान्य कार्रवाइयों से गड़बड़ियां दिखेंगी. अगर यह वैल्यू 'गलत' है, तो सभी ऑपरेशन एक ही लेन-देन में तब ही किए जाएंगे, जब वे सभी मान्य हों. डिफ़ॉल्ट रूप से, यह 'गलत' पर सेट होती है.
validateOnly

boolean

अगर यह सही है, तो अनुरोध की पुष्टि हो जाती है, लेकिन उसे लागू नहीं किया जाता. सिर्फ़ गड़बड़ियां दिखती हैं, नतीजे नहीं.

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

कीवर्ड प्लान के विज्ञापन ग्रुप में बदलाव करने के लिए रिस्पॉन्स मैसेज.

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

JSON के काेड में दिखाना 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (MutateKeywordPlanAdGroupResult)
    }
  ]
}
फ़ील्ड
partialFailureError

object (Status)

ऐसी गड़बड़ियां जो 'कुछ हद तक फ़ेलियर' मोड में काम न करने की वजह से होती हैं. यह वैल्यू सिर्फ़ तब दिखती है, जब partialFailure = true हो और सभी गड़बड़ियां ऑपरेशन के दौरान होती हैं. अगर कार्रवाइयों के अलावा कोई और गड़बड़ी होती है, तो हम आरपीसी लेवल की गड़बड़ी दिखाते हैं. उदाहरण के लिए, पुष्टि करने से जुड़ी गड़बड़ियां.
results[]

object (MutateKeywordPlanAdGroupResult)

बदलाव के सभी नतीजे. नतीजों का क्रम, मूल अनुरोध में कीवर्ड के क्रम से तय होता है.

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

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

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

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