Method: advertisers.adAssets.upload

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

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

הכלי תומך רק בהעלאת נכסים עם התבנית AdAssetType AD_ASSET_TYPE_IMAGE.

בקשת HTTP

  • ‫URI להעלאה, לבקשות להעלאת מדיה:
    POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/adAssets:uploadAdAsset
  • ‫URI של מטא-נתונים, לבקשות של מטא-נתונים בלבד:
    POST https://displayvideo.googleapis.com/v4/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.