Method: customers.adGroupAssetSets.mutate

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

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

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

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

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

पैरामीटर
customerId

string

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

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

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

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

object (AdGroupAssetSetOperation)

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

boolean

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

boolean

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

enum (ResponseContentType)

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

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

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

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

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

object (MutateAdGroupAssetSetResult)

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

object (Status)

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

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

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

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

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

AdGroupAssetSetOperation

विज्ञापन ग्रुप के किसी ऐसेट सेट पर एक ही ऑपरेशन (बनाएं, हटाएं).

जेएसओएन के काेड में दिखाना 
{

  // Union field operation can be only one of the following:
  "create": {
    object (AdGroupAssetSet)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
फ़ील्ड
यूनियन फ़ील्ड operation. बदलाव करने की कार्रवाई. operation इनमें से सिर्फ़ एक हो सकती है:
create

object (AdGroupAssetSet)

बनाएं कार्रवाई: नए विज्ञापन ग्रुप ऐसेट के सेट के लिए, संसाधन का कोई नाम नहीं होना चाहिए.
remove

string

हटाएं कार्रवाई: हटाए गए विज्ञापन ग्रुप के एसेट सेट के लिए, संसाधन का नाम इस फ़ॉर्मैट में होना चाहिए: customers/{customerId}/adGroupAssetSets/{adGroupId}~{asset_set_id}

MutateAdGroupAssetSetResult

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

जेएसओएन के काेड में दिखाना 
{
  "resourceName": string,
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  }
}
फ़ील्ड
resourceName

string

सफल संचालन के लिए वापस लौटाया गया.
adGroupAssetSet

object (AdGroupAssetSet)

बदली गई विज्ञापन ग्रुप ऐसेट का सेट, जिसमें बदलाव के बाद सिर्फ़ ऐसे फ़ील्ड शामिल किए जा सकते हैं जिनमें बदलाव किया जा सकता है. इस फ़ील्ड को सिर्फ़ तब दिखाया जाएगा, जबResponseContentType को "MUTABLE_resources" पर सेट किया जाए.