Conversion: updateAvailability

מעדכן את הזמינות של קבוצת פעילויות של Floodlight ב-DoubleClick Search. רוצים לנסות עכשיו?

בקשה

בקשת HTTP

POST https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability

אישור

הבקשה הזו מחייבת הרשאה עם ההיקף הבא:

היקף
https://www.googleapis.com/auth/doubleclicksearch

מידע נוסף זמין בדף אימות והרשאה.

גוף הבקשה

בגוף הבקשה, מספקים את הנתונים במבנה הבא:

{
  "availabilities": [
    {
      "agencyId": long,
      "advertiserId": long,
      "customerId": string,
      "segmentationType": string,
      "segmentationId": long,
      "segmentationName": string,
      "availabilityTimestamp": unsigned long
    }
  ]
}
שם הנכס ערך תיאור הערות
availabilities[] list נתוני הזמינות המבוקשים.
availabilities[].agencyId long מזהה הסוכנות ב-DS.
availabilities[].advertiserId long מזהה המפרסם ב-DS.
availabilities[].segmentationType string סוג הפילוח שעבורו הזמינות הזו מיועדת (ערך ברירת המחדל שלו הוא FLOODLIGHT).

הערכים הקבילים הם:
  • "FLOODLIGHT"
availabilities[].segmentationId long מזהה הפילוח המספרי (לדוגמה, מזהה פעילות ב-DoubleClick Search Floodlight).
availabilities[].segmentationName string מזהה הפילוח הידידותי (לדוגמה, שם פעילות ב-DoubleClick Search Floodlight).
availabilities[].availabilityTimestamp unsigned long השעה שבה הועלו כל ההמרות, בתקופת זמן של אלפיות השנייה לפי שעון UTC.
availabilities[].customerId string מספר הלקוח בממשק החדש של Search Ads 360. החשבון הזה חייב להיות חשבון ניהול משני.

תשובה

אם הפעולה בוצעה ללא שגיאות, השיטה הזו מחזירה גוף תגובה עם המבנה הבא:

{
  "availabilities": [
    {
      "agencyId": long,
      "advertiserId": long,
      "customerId": string,
      "segmentationType": string,
      "segmentationId": long,
      "segmentationName": string,
      "availabilityTimestamp": unsigned long
    }
  ]
}
שם הנכס ערך תיאור הערות
availabilities[] list נתוני הזמינות שהוחזרו.
availabilities[].agencyId long מזהה הסוכנות ב-DS.
availabilities[].advertiserId long מזהה המפרסם ב-DS.
availabilities[].segmentationType string סוג הפילוח שעבורו הזמינות הזו מיועדת (ערך ברירת המחדל שלו הוא FLOODLIGHT).

הערכים הקבילים הם:
  • "FLOODLIGHT"
availabilities[].segmentationId long מזהה הפילוח המספרי (לדוגמה, מזהה פעילות ב-DoubleClick Search Floodlight).
availabilities[].segmentationName string מזהה הפילוח הידידותי (לדוגמה, שם פעילות ב-DoubleClick Search Floodlight).
availabilities[].availabilityTimestamp unsigned long השעה שבה הועלו כל ההמרות, בתקופת זמן של אלפיות השנייה לפי שעון UTC.
availabilities[].customerId string מספר הלקוח בממשק החדש של Search Ads 360. החשבון הזה חייב להיות חשבון ניהול משני.

נסה בעצמך!

אפשר להשתמש ב-APIs Explorer שבהמשך כדי להפעיל את השיטה הזו בנתונים בזמן אמת ולראות את התגובה. לחלופין, אפשר לנסות את עצמאי חוקר.