הוצאנו משימוש את Search Ads 360 Reporting API הקודם. עכשיו אפשר ליצור דוחות באמצעות Search Ads 360 Reporting API החדש.

חשוב לזכור שSearch Ads 360 Conversion API לא מושפע מהשינוי הזה, והתמיכה בו תמשיך.

דף זה תורגם על ידי Cloud Translation API.

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 שבהמשך כדי להפעיל את השיטה הזו בנתונים בזמן אמת ולראות את התגובה. לחלופין, אפשר לנסות את עצמאי חוקר.