Method: firstAndThirdPartyAudiences.editCustomerMatchMembers

עדכון רשימת החברים של קהל בהתאמה ללקוחות.

התכונה נתמכת רק ב-audienceType הבאים:

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID

בקשת HTTP

POST https://displayvideo.googleapis.com/v3/firstAndThirdPartyAudiences/{firstAndThirdPartyAudienceId}:editCustomerMatchMembers

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

פרמטרים של נתיב

פרמטרים
firstAndThirdPartyAudienceId

string (int64 format)

חובה. המזהה של קהל ההתאמה ללקוחות FirstAnd הודעת הצד השלישי שהחברים בו יעברו עריכה.

גוף הבקשה

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

ייצוג JSON
{
  "advertiserId": string,

  // Union field added_members can be only one of the following:
  "addedContactInfoList": {
    object (ContactInfoList)
  },
  "addedMobileDeviceIdList": {
    object (MobileDeviceIdList)
  }
  // End of list of possible types for union field added_members.

  // Union field removed_members can be only one of the following:
  "removedContactInfoList": {
    object (ContactInfoList)
  },
  "removedMobileDeviceIdList": {
    object (MobileDeviceIdList)
  }
  // End of list of possible types for union field removed_members.
}
שדות
advertiserId

string (int64 format)

חובה. המזהה של המפרסם שמוגדר כבעלים של המאפיין 'התאמה ללקוחות' המעודכן בשדה 'התאמה ללקוחות'.

שדה האיחוד added_members. החברים שרוצים להוסיף לקהל ההתאמה ללקוחות. הערך של added_members יכול להיות רק אחת מהאפשרויות הבאות:
addedContactInfoList

object (ContactInfoList)

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

addedMobileDeviceIdList

object (MobileDeviceIdList)

קלט בלבד. רשימה של מזהים של מכשירים ניידים להגדרת המשתמשים שיש להוסיף.

שדה האיחוד removed_members. המשתתפים שרוצים להסיר מהקהל 'התאמה ללקוחות'. הערך של removed_members יכול להיות רק אחת מהאפשרויות הבאות:
removedContactInfoList

object (ContactInfoList)

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

removedMobileDeviceIdList

object (MobileDeviceIdList)

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

גוף התשובה

התשובה של FirstAndThirdPartyAudienceService.EditCustomerMatchMembers.

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

ייצוג ב-JSON
{
  "firstAndThirdPartyAudienceId": string
}
שדות
firstAndThirdPartyAudienceId

string (int64 format)

חובה. המזהה של FirstAndThirdPartyAudience המעודכן של התאמה ללקוחות.

היקפי הרשאה

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/display-video

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.