Method: advertisers.sdfuploadtasks.upload

יצירת משימה להעלאת SDF. הפונקציה מחזירה Operation.

משימה להעלאת SDF היא פעולה ממושכת ואסינכרונית. הסוג metadata של הפעולה הזו הוא SdfUploadTaskMetadata. אם הבקשה מסתיימת בהצלחה, הסוג response של הפעולה הוא SdfUploadTask. התגובה לא תכלול את הקבצים שנוצרו, שאפשר לאחזר אותם באמצעות media.download.

אפשר לאחזר את מצב הפעולה באמצעות sdfuploadtask.operations.get.

כל השגיאות מופיעות ב-error.message. הערה: השדה error.details אמור להיות ריק.

בקשת HTTP

  • URI להעלאה, לבקשות העלאה של מדיה:
    POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/sdfuploadtasks
  • URI של מטא-נתונים, לבקשות של מטא-נתונים בלבד:
    POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/sdfuploadtasks

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

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

פרמטרים
advertiserId

string (int64 format)

חובה. המזהה של המפרסם שעבורו רוצים להעלות קובץ SDF.

גוף הבקשה

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

ייצוג ב-JSON 
{
  "filename": string,
  "sdfVersion": enum (SdfVersion)
}
שדות
filename

string

חובה. שם הקובץ של הנכס, כולל הסיומת של הקובץ. שם הקובץ חייב להיות מקודד ב-UTF-8 בגודל מקסימלי של 240 בייטים.
sdfVersion

enum (SdfVersion)

חובה. גרסת ה-SDF של הקובץ שהועלו. אם ההגדרה היא SDF_VERSION_UNSPECIFIED, הגרסה שתוגדר כברירת מחדל תהיה הגרסה שצוינה על ידי המפרסם שזוהה. המפרסם יורש את גרסת ה-SDF מהשותף שלו, אלא אם מוגדר אחרת.

גוף התשובה

אם הפעולה מצליחה, גוף התגובה מכיל מופע של Operation.

היקפי הרשאה

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

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

מידע נוסף זמין בOAuth 2.0 Overview.