Method: advertisers.adAssets.upload

מעלה ויוצר נכס שמצורף למודעה.

הפונקציה מחזירה את המזהה של הנכס החדש שצורף למודעה.

אפשר להעלות רק נכסים עם AdAssetType AD_ASSET_TYPE_IMAGE.

בקשת HTTP

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

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

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

פרמטרים
advertiserId

string (int64 format)

חובה. המזהה של המפרסם שהנכס שמצורף למודעה שייך אליו.

גוף הבקשה

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

ייצוג ב-JSON 
{
  "filename": string,
  "adAssetType": enum (AdAssetType),
  "syntheticContentAttestationStatus": enum (SyntheticContentAttestationStatus)
}
שדות
filename

string

חובה. שם הקובץ של הנכס שמצורף למודעה, כולל סיומת הקובץ.

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

enum (AdAssetType)

חובה. סוג הנכס שמצורף למודעה.

יש תמיכה רק ב-AD_ASSET_TYPE_IMAGE.
syntheticContentAttestationStatus

enum (SyntheticContentAttestationStatus)

אופציונלי. אם להוסיף לנכס תווית שמציינת שהוא נוצר או נערך באמצעות AI, כשהוא מוצג באזורים שבהם יש תקנות מקומיות בנושא תוויות AI.

גוף התשובה

הודעת תשובה ל-adAssets.upload.

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

ייצוג ב-JSON 
{
  "adAsset": {
    object (AdAsset)
  }
}
שדות
adAsset

object (AdAsset)

הנכס שמצורף למודעה שנוצר.

היקפי הרשאות

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.