Method: customers.generateShareablePreviews

返回所请求的可共享预览。

HTTP 请求

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

网址采用 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

可共享的预览网址。
expirationDateTime

string

失效日期时间，采用 ISO-8601 格式。