Method: customers.customerClientLinks.mutate

ग्राहक क्लाइंट लिंक बनाता या अपडेट करता है. कार्रवाई की स्थितियां दिखाई जाती हैं.

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

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

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

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

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

पैरामीटर
customerId

string

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

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

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

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

object (CustomerClientLinkOperation)

ज़रूरी है. अलग-अलग CustomerClientLink पर की जाने वाली कार्रवाई.
validateOnly

boolean

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

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

CustomerClientLink बदलाव के लिए रिस्पॉन्स मैसेज.

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

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

object (MutateCustomerClientLinkResult)

ऐसा नतीजा जो उस संसाधन की पहचान करता है जिस पर बदलाव करने के अनुरोध का असर हुआ है.

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

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

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

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

CustomerClientLinkOperation

CustomerClientLink पर एक सिंगल ऑपरेशन (बनाएं और अपडेट करें).

जेएसओएन के काेड में दिखाना 
{
  "updateMask": string,

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

string (FieldMask format)

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

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

object (CustomerClientLink)

बनाएं कार्रवाई: नए लिंक के लिए संसाधन का कोई नाम नहीं होना चाहिए.
update

object (CustomerClientLink)

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

MutateCustomerClientLinkResult

किसी एक ग्राहक क्लाइंट लिंक में बदलाव करने से मिला नतीजा.

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

string

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