Method: audienceMembers.ingest

यह फ़ंक्शन, दिए गए Destination में AudienceMember संसाधनों की सूची अपलोड करता है.

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

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. UserData या MobileData को शामिल करते समय, इसे स्वीकार करना ज़रूरी है. यह फ़ील्ड, पार्टनर मैच के लिए बनाई गई लोगों की लिस्ट के लिए ज़रूरी नहीं है.

TermsOfServiceStatus

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

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