Method: audienceMembers.ingest

העלאה של רשימת AudienceMember משאבים אל Destination שצוין.

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.

גוף הבקשה

גוף הבקשה מכיל נתונים עם המבנה הבא:

ייצוג ב-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

מייצג את ההחלטה של המתקשר לאשר או לדחות את התנאים וההגבלות.

טיפוסים בני מנייה (enum)
TERMS_OF_SERVICE_STATUS_UNSPECIFIED לא צוין.
ACCEPTED סטטוס שמציין שהמתקשר בחר לאשר את התנאים וההגבלות.
REJECTED סטטוס שמציין שהמתקשר בחר לדחות את התנאים וההגבלות.