Method: customers.adGroupAds.mutate

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

AdCustomizerErrorAdErrorAdGroupAdErrorAdSharingErrorAdxErrorAssetErrorAssetLinkErrorAuthenticationErrorAuthorizationErrorCollectionSizeErrorContextErrorDatabaseErrorDateErrorDistinctErrorFeedAttributeReferenceErrorFieldErrorFieldMaskErrorFunctionErrorFunctionParsingErrorHeaderErrorIdErrorImageErrorInternalErrorListOperationErrorMediaBundleErrorMediaFileErrorMutateErrorNewResourceCreationErrorNotEmptyErrorNullErrorOperationAccessDeniedErrorOperatorErrorPolicyFindingErrorPolicyValidationParameterErrorPolicyViolationErrorQuotaErrorRangeErrorRequestErrorResourceCountLimitExceededErrorSizeLimitErrorStringFormatErrorStringLengthErrorUrlFieldError

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

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

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

पाथ पैरामीटर

पैरामीटर
customerId

string

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

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

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

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

object (AdGroupAdOperation)

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

boolean

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

boolean

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

enum (ResponseContentType)

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

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

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

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

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

object (Status)

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

object (MutateAdGroupAdResult)

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

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

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

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

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