Method: customers.accountLinks.mutate

खाता लिंक बनाता है या हटाता है. V5 से, AccountLinkService.MutateAccountLink के ज़रिए खाता बनाने की सुविधा काम नहीं करती. इसके बजाय, AccountLinkService.CreateAccountLink का इस्तेमाल करें.

दिखने वाली गड़बड़ियों की सूची: AccountLinkError AuthenticationError AuthorizationError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError

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

POST https://googleads.googleapis.com/v19/customers/{customerId}/accountLinks:mutate

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

पाथ पैरामीटर

पैरामीटर
customerId

string

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

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

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

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

object (AccountLinkOperation)

ज़रूरी है. लिंक पर की जाने वाली कार्रवाई.
partialFailure

boolean

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

boolean

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

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

खाता लिंक करने के लिए किए गए बदलाव का जवाब.

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

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

object (MutateAccountLinkResult)

बदलाव का नतीजा.
partialFailureError

object (Status)

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

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

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

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

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

AccountLinkOperation

खाते के लिंक से जुड़ा एक अपडेट.

JSON के काेड में दिखाना 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "update": {
    object (AccountLink)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
फ़ील्ड
updateMask

string (FieldMask format)

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

यह फ़ील्ड के पूरी तरह से क्वालिफ़ाइड नामों की सूची है. इसमें नामों को कॉमा लगाकर अलग किया गया है. उदाहरण: "user.displayName,photo".
यूनियन फ़ील्ड operation. की जाने वाली कार्रवाई. operation इनमें से कोई एक हो सकता है:
update

object (AccountLink)

अपडेट करने की कार्रवाई: खाते के लिंक में, रिसॉर्स का मान्य नाम होना चाहिए.
remove

string

हटाने की कार्रवाई: हटाए जाने वाले खाते के लिंक का नाम, इस फ़ॉर्मैट में होना चाहिए:

customers/{customerId}/accountLinks/{accountLinkId}

MutateAccountLinkResult

खाता लिंक करने के नतीजे में बदलाव होता है.

JSON के काेड में दिखाना 
{
  "resourceName": string
}
फ़ील्ड
resourceName

string

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