Method: customers.googleAds.mutate

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

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

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

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

Atomic लेन-देन के फ़ायदे

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

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

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

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

ध्यान दें:

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

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

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

{/0AdCustomizerErrorAdErrorAdGroupAdErrorAdGroupCriterionErrorAdGroupErrorAssetErrorAuthenticationErrorAuthorizationErrorBiddingErrorCampaignBudgetErrorCampaignCriterionErrorCampaignErrorCampaignExperimentErrorCampaignSharedSetErrorCollectionSizeErrorContextErrorConversionActionErrorCriterionErrorCustomerFeedErrorDatabaseErrorDateErrorDateRangeErrorDistinctErrorExtensionFeedItemErrorExtensionSettingErrorFeedAttributeReferenceErrorFeedErrorFeedItemErrorFeedItemSetErrorFieldErrorFieldMaskErrorFunctionParsingErrorHeaderErrorImageErrorInternalErrorKeywordPlanAdGroupKeywordErrorKeywordPlanCampaignErrorKeywordPlanErrorLabelErrorListOperationErrorMediaUploadErrorMutateErrorNewResourceCreationErrorNullErrorOperationAccessDeniedErrorPolicyFindingErrorPolicyViolationErrorQuotaErrorRangeErrorRequestErrorResourceCountLimitExceededErrorSettingErrorSharedSetErrorSizeLimitErrorStringFormatErrorStringLengthErrorUrlFieldErrorUserListErrorYoutubeVideoRegistrationError

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

POST https://googleads.googleapis.com/v16/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)

रिस्पॉन्स कॉन्टेंट टाइप की सेटिंग. इससे तय होता है कि पोस्ट म्यूटेशन के बाद, बदला जा सकने वाला रिसॉर्स है या सिर्फ़ संसाधन का नाम. बदला जा सकने वाला रिसॉर्स सिर्फ़ तब दिखाया जाएगा, जब संसाधन में सही रिस्पॉन्स फ़ील्ड हो. उदाहरण के लिए, MotateCampaignresults.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 की खास जानकारी देखें.