הממשק הקודם של Search Ads 360 Reporting API יוצא משימוש ב-30 ביוני 2024. חשוב לדעת ש-Search Ads 360 Conversion API לא מושפע מכך, ונמשיך לתמוך בו. בכל פיתוח הדוחות החדש יש להשתמש ב-Search Ads 360 Reporting API החדש.

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

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