Method: customers.customAudiences.mutate

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

फेंकी गई गड़बड़ियों की सूची: AuthenticationError AuthorizationError CustomAudienceError CustomInterestError FieldError FieldMaskError HeaderError InternalError MutateError OperationAccessDeniedError PolicyViolationErrorQuotaErrorRequestError

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

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

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

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

पैरामीटर
customerId

string

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

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

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

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

object (CustomAudienceOperation)

ज़रूरी है. अलग-अलग कस्टम ऑडियंस पर की जाने वाली कार्रवाइयों की सूची.
validateOnly

boolean

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

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

कस्टम ऑडियंस में बदलाव करने के लिए रिस्पॉन्स मैसेज.

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

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

object (MutateCustomAudienceResult)

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

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

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

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

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

CustomAudienceOperation

कस्टम ऑडियंस पर एक कार्रवाई (बनाएं, अपडेट करें).

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

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

string (FieldMask format)

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

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

object (CustomAudience)

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

object (CustomAudience)

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

string

हटाएं कार्रवाई: हटाई गई कस्टम ऑडियंस के लिए संसाधन का नाम इस फ़ॉर्मैट में होना चाहिए:

customers/{customerId}/customAudiences/{custom_audience_id}

MutateCustomAudienceResult

कस्टम ऑडियंस म्यूटेट का नतीजा.

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

string

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