Method: customers.googleAds.mutate

संसाधनों को बनाता, अपडेट करता है या हटाता है. यह तरीका कई तरह के संसाधनों के साथ ऐटॉमिक लेन-देन का इस्तेमाल करता है. उदाहरण के लिए, अपने-आप कोई कैंपेन और कैंपेन बजट बनाया जा सकता है या अपने-आप हज़ारों बदलाव किए जा सकते हैं.

यह तरीका, बदलाव करने के तरीकों की सीरीज़ के साथ एक रैपर है. इन तरीकों को सीधे कॉल करने पर, यह सुविधा सिर्फ़ ये सुविधाएं उपलब्ध कराती है:

  • ऐटॉमिक ट्रांज़ैक्शन
  • अस्थायी संसाधन के नाम (इसके बारे में नीचे बताया गया है)
  • एक के बाद एक कई कॉल करने पर, इंतज़ार का समय कुछ कम हुआ

ध्यान दें: सिर्फ़ ऐटॉमिक ट्रांज़ैक्शन के साथ काम करने वाले संसाधन शामिल किए जाते हैं. इसलिए, यह तरीका अलग-अलग सेवाओं के लिए किए गए सभी कॉल को नहीं बदल सकता.

ऐटॉमिक ट्रांज़ैक्शन के फ़ायदे

ऐटॉमिकिटी से गड़बड़ियों को आसानी से हैंडल किया जा सकता है. अगर कई बार बदलाव किए जा रहे हैं और इनमें से कोई बदलाव काम नहीं करता, तो इसकी वजह से आपके खाते में गड़बड़ी हो सकती है. परोक्षता से, या तो आप सीधे चुनी गई स्थिति तक पहुंचते हैं या अनुरोध विफल हो जाता है और फिर से प्रयास कर सकते हैं.

अस्थायी संसाधनों के नाम

अस्थायी संसाधन नाम, खास तरह के संसाधन नाम होते हैं. इनका इस्तेमाल संसाधन बनाने और उसी संसाधन का रेफ़रंस देने के लिए किया जाता है. उदाहरण के लिए, अगर किसी कैंपेन का बजट resourceName के लिए customers/123/campaignBudgets/-1 के बराबर है, तो उसी अनुरोध के Campaign.budget फ़ील्ड में संसाधन का नाम फिर से इस्तेमाल किया जा सकता है. इस तरह, दोनों संसाधन ऐटॉमली तरीके से बनाए और लिंक किए जाते हैं.

अस्थायी रिसॉर्स का नाम बनाने के लिए, नाम के हिस्से में नेगेटिव नंबर डालें, जिसे सर्वर आम तौर पर असाइन करता है.

ध्यान दें:

  • नाम का फिर से इस्तेमाल करने से पहले, संसाधन एक अस्थायी नाम के साथ बनाए जाने चाहिए. उदाहरण के लिए, अगर बदलाव करने का ऑर्डर वापस ले लिया जाता है, तो पिछले Campaignबजट+Campaign का उदाहरण काम नहीं करेगा.
  • सभी अनुरोधों में, अस्थायी नामों को याद नहीं रखा जाता है.
  • साथ ही, अनुरोध के लिए, तापमानों के नामों की संख्या के लिए कोई सीमा नहीं होती है.
  • हर अस्थायी नाम में एक यूनीक नेगेटिव नंबर का इस्तेमाल होना चाहिए, भले ही संसाधन के टाइप अलग-अलग हों.

इंतज़ार का समय

ज़रूरी है कि म्यूटेट को संसाधन के टाइप के हिसाब से ग्रुप किया जाए. ऐसा न करने पर, अनुरोध का समय खत्म हो सकता है और अनुरोध पूरा नहीं हो पाएगा. इंतज़ार का समय, बदलाव करने के अलग-अलग तरीकों के लिए कॉल की सीरीज़ के बराबर होता है. इसमें, रिसॉर्स टाइप में होने वाला हर बदलाव एक नया कॉल होता है. उदाहरण के लिए, 10 कैंपेन को बदलने पर, 10 विज्ञापन ग्रुप में बदलाव करने पर दो कॉल की तरह ही बदलाव होगा, जबकि 1 कैंपेन, 1 विज्ञापन ग्रुप, 1 कैंपेन, और 1 विज्ञापन ग्रुप में बदलाव करना, चार कॉल के बराबर है.

खाकाAdCustomizerErrorAdErrorAdGroupAdErrorAdGroupCriterionErrorAdGroupErrorAssetErrorAuthenticationErrorAuthorizationErrorBiddingErrorCampaignBudgetErrorCampaignCriterionErrorCampaignErrorCampaignExperimentErrorCampaignSharedSetErrorCollectionSizeErrorContextErrorConversionActionErrorCriterionErrorCustomerFeedErrorDatabaseErrorDateErrorDateRangeErrorDistinctErrorExtensionFeedItemErrorExtensionSettingErrorFeedAttributeReferenceErrorFeedErrorFeedItemErrorFeedItemSetErrorFieldErrorFieldMaskErrorFunctionParsingErrorHeaderErrorImageErrorInternalErrorKeywordPlanAdGroupKeywordErrorKeywordPlanCampaignErrorKeywordPlanErrorLabelErrorListOperationErrorMediaUploadErrorMutateErrorNewResourceCreationErrorNullErrorOperationAccessDeniedErrorPolicyFindingErrorPolicyViolationErrorQuotaErrorRangeErrorRequestErrorResourceCountLimitExceededErrorSettingErrorSharedSetErrorSizeLimitErrorStringFormatErrorStringLengthErrorUrlFieldErrorUserListErrorYoutubeVideoRegistrationError

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

POST https://googleads.googleapis.com/v14/customers/{customerId}/googleAds:mutate

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

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

पैरामीटर
customerId

string

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

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

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

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

object (MutateOperation)

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

boolean

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

boolean

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

enum (ResponseContentType)

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

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

GoogleAdsService.Mutate के लिए जवाब.

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

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

object (Status)

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

object (MutateOperationResponse)

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

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

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

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

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