Method: firstAndThirdPartyAudiences.editCustomerMatchMembers

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

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

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
firstAndThirdPartyAudienceId

string (int64 format)

חובה. המזהה של ה'התאמה ללקוחות' של FirstAndThirdPartyAudience שחבריו יעברו עריכה.

גוף הבקשה

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

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

חובה. המזהה של המפרסם שמוגדר כבעלים של ההתאמה ללקוחות – FirstAndThirdPartyAudience.
שדה איחוד 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.