Method: audienceMembers.ingest

AudienceMember रिसॉर्स की सूची को, दिए गए Destination में अपलोड करता है.

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

POST https://datamanager.googleapis.com/v1/audienceMembers:ingest

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

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

अनुरोध के मुख्य भाग में, नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:

JSON के काेड में दिखाना 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "audienceMembers": [
    {
      object (AudienceMember)
    }
  ],
  "consent": {
    object (Consent)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding),
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "termsOfService": {
    object (TermsOfService)
  }
}
फ़ील्ड
destinations[]

object (Destination)

ज़रूरी है. ऑडियंस के सदस्यों को भेजने के लिए डेस्टिनेशन की सूची.
audienceMembers[]

object (AudienceMember)

ज़रूरी है. चुने गए डेस्टिनेशन पर भेजने के लिए उपयोगकर्ताओं की सूची. एक अनुरोध में ज़्यादा से ज़्यादा 10,000 AudienceMember संसाधन भेजे जा सकते हैं.
consent

object (Consent)

ज़रूरी नहीं. अनुरोध में शामिल सभी उपयोगकर्ताओं पर लागू होने के लिए, अनुरोध-लेवल की सहमति. उपयोगकर्ता-लेवल की सहमति, अनुरोध-लेवल की सहमति को बदल देती है. साथ ही, इसे हर AudienceMember में बताया जा सकता है.
validateOnly

boolean

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

enum (Encoding)

ज़रूरी नहीं. UserData अपलोड करने के लिए ज़रूरी है. उपयोगकर्ता आइडेंटिफ़ायर का एन्कोडिंग टाइप. हैश किए गए उपयोगकर्ता आइडेंटिफ़ायर के लिए, यह हैश की गई स्ट्रिंग का एन्कोडिंग टाइप है. एन्क्रिप्ट (सुरक्षित) की गई हैश की गई उपयोगकर्ता आइडेंटिफ़ायर के लिए, यह एन्क्रिप्ट की गई बाहरी स्ट्रिंग का एन्कोडिंग टाइप है. हालांकि, यह ज़रूरी नहीं है कि यह अंदरूनी हैश की गई स्ट्रिंग का एन्कोडिंग टाइप भी हो. इसका मतलब है कि अंदरूनी हैश की गई स्ट्रिंग को, बाहरी एन्क्रिप्ट की गई स्ट्रिंग से अलग तरीके से एन्कोड किया जा सकता है. UserData अपलोड के लिए, इस फ़ील्ड को अनदेखा कर दिया जाता है.
encryptionInfo

object (EncryptionInfo)

ज़रूरी नहीं. UserData अपलोड के लिए, एन्क्रिप्शन की जानकारी. अगर यह सेट नहीं है, तो यह माना जाता है कि पहचान ज़ाहिर करने वाली अपलोड की गई जानकारी को हैश किया गया है, लेकिन एन्क्रिप्ट (सुरक्षित) नहीं किया गया है. UserData अपलोड के लिए, इस फ़ील्ड को अनदेखा कर दिया जाता है.
termsOfService

object (TermsOfService)

ज़रूरी नहीं. सेवा की वे शर्तें जिन्हें उपयोगकर्ता ने स्वीकार/अस्वीकार किया है.

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

IngestAudienceMembersRequest से मिला जवाब.

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

JSON के काेड में दिखाना 
{
  "requestId": string
}
फ़ील्ड
requestId

string

अनुरोध का अपने-आप जनरेट हुआ आईडी.

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

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

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

TermsOfService

सेवा की वे शर्तें जिन्हें उपयोगकर्ता ने स्वीकार/अस्वीकार किया है.

JSON के काेड में दिखाना 
{
  "customerMatchTermsOfServiceStatus": enum (TermsOfServiceStatus)
}
फ़ील्ड
customerMatchTermsOfServiceStatus

enum (TermsOfServiceStatus)

ज़रूरी नहीं. ग्राहक मिलान की सेवा की शर्तें: https://support.google.com/adspolicy/answer/6299717. कस्टमर मैच की उपयोगकर्ता सूचियों में किए जाने वाले सभी अपलोड के लिए, यह स्वीकार करना ज़रूरी है.

TermsOfServiceStatus

इससे पता चलता है कि कॉलर ने सेवा की शर्तों को स्वीकार किया है या अस्वीकार किया है.

Enums
TERMS_OF_SERVICE_STATUS_UNSPECIFIED इसकी जानकारी नहीं दी गई है.
ACCEPTED कॉलर ने सेवा की शर्तें स्वीकार करने का विकल्प चुना है.
REJECTED स्टेटस से पता चलता है कि कॉलर ने सेवा की शर्तों को अस्वीकार करने का विकल्प चुना है.