Method: customers.adGroupAssetSets.mutate

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

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

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

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

पाथ पैरामीटर

पैरामीटर
customerId

string

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

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

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

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

object (AdGroupAssetSetOperation)

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

boolean

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

boolean

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

enum (ResponseContentType)

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

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

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

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

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

object (MutateAdGroupAssetSetResult)

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

object (Status)

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

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

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

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

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

AdGroupAssetSetOperation

विज्ञापन ग्रुप ऐसेट सेट पर एक बार में किया गया कोई काम (बनाना, हटाना).

JSON के काेड में दिखाना 
{

  // 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

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

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

string

यह वैल्यू, ऑपरेशन के पूरा होने पर दिखती है.
adGroupAssetSet

object (AdGroupAssetSet)

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