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,
  "fieldWarnings": [
    {
      object (FieldWarning)
    }
  ]
}
שדות
requestId

string

המזהה שנוצר אוטומטית של הבקשה.
fieldWarnings[]

object (FieldWarning)

אזהרות מפורטות ברמת השורה עם נתיבי שדות.

היקפי הרשאות

נדרש היקף ההרשאות הבא של 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

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

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