Method: customers.userLists.mutate

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

थ्रोन गड़बड़ियों की सूची: AuthenticationError AuthorizationError CollectionSizeError DatabaseError DistinctError FieldError FieldMaskError HeaderError InternalError MutateError NewResourceCreationErrorNotAllowlistedErrorNotEmptyErrorOperationAccessDeniedErrorQuotaErrorRangeErrorRequestErrorStringFormatErrorStringLengthErrorUserListError

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

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

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

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

पैरामीटर
customerId

string

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

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

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

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

object (UserListOperation)

ज़रूरी है. अलग-अलग उपयोगकर्ता सूचियों पर की जाने वाली कार्रवाइयों की सूची.
partialFailure

boolean

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

boolean

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

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

उपयोगकर्ता सूची में बदलाव करने के लिए रिस्पॉन्स मैसेज.

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

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

object (Status)

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

object (MutateUserListResult)

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

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

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

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

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