Method: customers.customAudiences.mutate

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

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

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

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

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

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

object (CustomAudience)

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

object (CustomAudience)

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

string

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

customers/{customerId}/customAudiences/{custom_audience_id}

MutateCustomAudienceResult

कस्टम ऑडियंस के बदलाव का नतीजा.

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

string

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