Method: customers.adGroupAssets.mutate

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

इस्तेमाल की गई गड़बड़ियों की सूची: AssetLinkError AuthenticationError AuthorizationError ContextError FieldError HeaderError InternalError MutateError NotAllowlistedError QuotaError RequestError

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

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

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

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

पैरामीटर
customerId

string

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

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

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

जेएसओएन के काेड में दिखाना 
{
  "operations": [
    {
      object (AdGroupAssetOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
फ़ील्ड
operations[]

object (AdGroupAssetOperation)

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

boolean

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

boolean

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

enum (ResponseContentType)

रिस्पॉन्स कॉन्टेंट टाइप की सेटिंग. इससे तय होता है कि पोस्ट म्यूटेशन के बाद, बदला जा सकने वाला रिसॉर्स है या सिर्फ़ संसाधन का नाम.

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

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

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

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

object (Status)

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

object (MutateAdGroupAssetResult)

बदलाव के लिए सभी नतीजे.

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

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

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

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