- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- इसे आज़माएं!
उपयोगकर्ता सूचियां बनाता या अपडेट करता है. कार्रवाई की स्थितियां दिखाई जाती हैं.
थ्रोन की गड़बड़ियों की सूची: AuthenticationError AuthorizationError CollectionSizeError DatabaseError DistinctError FieldError FieldMaskError HeaderError InternalError MutateError NewResourceCreationErrorNotAllowlistedErrorNotEmptyErrorOperationAccessDeniedErrorQuotaErrorRangeErrorRequestErrorStringFormatErrorStringLengthErrorUserListError
एचटीटीपी अनुरोध
POST https://googleads.googleapis.com/v14/customers/{customerId}/userLists:mutate
यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
customerId |
ज़रूरी है. उस ग्राहक का आईडी जिसकी उपयोगकर्ता सूचियों में बदलाव किया जा रहा है. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{
"operations": [
{
object ( |
फ़ील्ड | |
---|---|
operations[] |
ज़रूरी है. अलग-अलग उपयोगकर्ता सूचियों पर की जाने वाली कार्रवाइयों की सूची. |
partialFailure |
सही होने पर, सही कार्रवाइयां की जाएंगी और अमान्य ऑपरेशन से गड़बड़ियां दिखेंगी. अगर गलत है, तो सभी कार्रवाइयां एक ही लेन-देन में तभी पूरी की जाएंगी, जब वे सभी मान्य हों. डिफ़ॉल्ट रूप से गलत पर सेट होती है. |
validateOnly |
सही होने पर, अनुरोध की पुष्टि की जाती है, लेकिन उसे लागू नहीं किया जाता है. सिर्फ़ गड़बड़ियां मिलती हैं, नतीजे नहीं. |
जवाब का मुख्य भाग
उपयोगकर्ता सूची के बदलाव के लिए रिस्पॉन्स मैसेज.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{ "partialFailureError": { object ( |
फ़ील्ड | |
---|---|
partialFailureError |
आंशिक फ़ेलियर मोड में कार्रवाई न हो पाने से जुड़ी गड़बड़ियां. सिर्फ़ तभी दिया जाता है, जबनैशनल फ़ंक्शन = true और सभी गड़बड़ियां ऑपरेशन में होती हैं. अगर ऑपरेशन के बाहर कोई गड़बड़ी होती है (उदाहरण के लिए, पुष्टि करने से जुड़ी गड़बड़ियां), तो हम RPC लेवल की गड़बड़ी दिखाते हैं. |
results[] |
बदलाव के लिए सभी नतीजे. |
अनुमति देने के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/adwords
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.