Method: customers.accountLinks.mutate

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

इस्तेमाल की गई गड़बड़ियों की सूची: AccountLinkError AuthenticationError AuthorizationError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError

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

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

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

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

object (AccountLink)

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

string

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

customers/{customerId}/accountLinks/{accountLinkId}

MutateAccountLinkResult

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

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

string

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