Method: customers.generateShareablePreviews

מחזירה את התצוגה המקדימה המבוקשת שניתנת לשיתוף.

בקשת HTTP

POST https://googleads.googleapis.com/v17/customers/{customerId}:generateShareablePreviews

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
customerId

string

שדה חובה. הלקוח יוצר את הבקשה לתצוגה מקדימה שניתנת לשיתוף.

גוף הבקשה

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

ייצוג JSON 
{
  "shareablePreviews": [
    {
      object (ShareablePreview)
    }
  ]
}
שדות
shareablePreviews[]

object (ShareablePreview)

שדה חובה. רשימת תצוגות מקדימות שניתן לשתף ליצירה.

גוף התשובה

הודעת תשובה עבור ShareablePreviewService.GenerateShareablePreviews.

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

ייצוג JSON 
{
  "responses": [
    {
      object (ShareablePreviewOrError)
    }
  ]
}
שדות
responses[]

object (ShareablePreviewOrError)

רשימה של יצירת תוצאות של תצוגה מקדימה שניתן לשתף.

היקפי ההרשאות

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

  • https://www.googleapis.com/auth/adwords

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

ShareablePreview

תצוגה מקדימה שניתנת לשיתוף עם המזהה שלה.

ייצוג JSON 
{
  "assetGroupIdentifier": {
    object (AssetGroupIdentifier)
  }
}
שדות
assetGroupIdentifier

object (AssetGroupIdentifier)

שדה חובה. קבוצת נכסים של התצוגה המקדימה שניתנת לשיתוף.

AssetGroupIdentifier

קבוצת נכסים של התצוגה המקדימה שניתנת לשיתוף.

ייצוג JSON 
{
  "assetGroupId": string
}
שדות
assetGroupId

string (int64 format)

שדה חובה. המזהה של קבוצת הנכסים.

ShareablePreviewOrError

התוצאה של יצירת תצוגה מקדימה שניתנת לשיתוף.

ייצוג JSON 
{
  "assetGroupIdentifier": {
    object (AssetGroupIdentifier)
  },

  // Union field generate_shareable_preview_response can be only one of the
  // following:
  "shareablePreviewResult": {
    object (ShareablePreviewResult)
  },
  "partialFailureError": {
    object (Status)
  }
  // End of list of possible types for union field
  // generate_shareable_preview_response.
}
שדות
assetGroupIdentifier

object (AssetGroupIdentifier)

קבוצת הנכסים של התצוגה המקדימה שניתנת לשיתוף.
שדה איחוד generate_shareable_preview_response. התוצאה או השגיאה של התצוגה המקדימה שניתן לשתף. generate_shareable_preview_response יכול להיות רק אחת מהאפשרויות הבאות:
shareablePreviewResult

object (ShareablePreviewResult)

התוצאה של התצוגה המקדימה שניתן לשתף.
partialFailureError

object (Status)

שגיאה בגלל שגיאה חלקית של התצוגה המקדימה שניתנת לשיתוף.

ShareablePreviewResult

הודעה לשמירת תוצאה של תצוגה מקדימה שניתנת לשיתוף.

ייצוג JSON 
{
  "shareablePreviewUrl": string,
  "expirationDateTime": string
}
שדות
shareablePreviewUrl

string

כתובת ה-URL של התצוגה המקדימה שניתן לשתף.
expirationDateTime

string

שעת תאריך התפוגה בפורמט ISO-8601.