Method: customers.keywordPlans.mutate

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

दिखने वाली गड़बड़ियों की सूची: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError KeywordPlanError MutateError NewResourceCreationError QuotaError RequestError ResourceCountLimitExceededError StringLengthError

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

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

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

पाथ पैरामीटर

पैरामीटर
customerId

string

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

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

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

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

object (KeywordPlanOperation)

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

boolean

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

boolean

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

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

कीवर्ड प्लान में बदलाव करने के अनुरोध का जवाब.

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

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

object (Status)

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

object (MutateKeywordPlansResult)

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

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

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

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

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