Method: customers.accountLinks.mutate

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

थ्रो की गई गड़बड़ियों की सूची: AccountLinkError AuthenticationError AuthorizationError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError

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

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

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

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

पैरामीटर
customerId

string

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

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

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

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

object (AccountLinkOperation)

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

boolean

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

boolean

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

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

खाता लिंक में बदलाव के लिए दिया गया जवाब.

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

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

object (MutateAccountLinkResult)

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

object (Status)

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

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

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

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

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

AccountLinkOperation

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

जेएसओएन के काेड में दिखाना 
{
  "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

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

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

string

सफल संचालन के लिए वापस लौटाया गया.