Asset

Thành phần là một phần của quảng cáo có thể được dùng chung trên nhiều quảng cáo. Đó có thể là hình ảnh (ImageAsset), video (YouTubeVideoAsset), v.v. Thành phần là không thể thay đổi và không thể xoá. Để dừng phân phát một thành phần, hãy xoá thành phần đó khỏi thực thể đang sử dụng thành phần đó.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "source": enum (AssetSource),
  "policySummary": {
    object (AssetPolicySummary)
  },
  "fieldTypePolicySummaries": [
    {
      object (AssetFieldTypePolicySummary)
    }
  ],
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "mediaBundleAsset": {
    object (MediaBundleAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "leadFormAsset": {
    object (LeadFormAsset)
  },
  "bookOnGoogleAsset": {
    object (BookOnGoogleAsset)
  },
  "promotionAsset": {
    object (PromotionAsset)
  },
  "calloutAsset": {
    object (CalloutAsset)
  },
  "structuredSnippetAsset": {
    object (StructuredSnippetAsset)
  },
  "sitelinkAsset": {
    object (SitelinkAsset)
  },
  "pageFeedAsset": {
    object (PageFeedAsset)
  },
  "dynamicEducationAsset": {
    object (DynamicEducationAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "hotelCalloutAsset": {
    object (HotelCalloutAsset)
  },
  "callAsset": {
    object (CallAsset)
  },
  "priceAsset": {
    object (PriceAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "dynamicRealEstateAsset": {
    object (DynamicRealEstateAsset)
  },
  "dynamicCustomAsset": {
    object (DynamicCustomAsset)
  },
  "dynamicHotelsAndRentalsAsset": {
    object (DynamicHotelsAndRentalsAsset)
  },
  "dynamicFlightsAsset": {
    object (DynamicFlightsAsset)
  },
  "discoveryCarouselCardAsset": {
    object (DiscoveryCarouselCardAsset)
  },
  "dynamicTravelAsset": {
    object (DynamicTravelAsset)
  },
  "dynamicLocalAsset": {
    object (DynamicLocalAsset)
  },
  "dynamicJobsAsset": {
    object (DynamicJobsAsset)
  },
  "locationAsset": {
    object (LocationAsset)
  },
  "hotelPropertyAsset": {
    object (HotelPropertyAsset)
  }
  // End of list of possible types for union field asset_data.
}
Trường
resourceName

string

Không thể thay đổi. Tên tài nguyên của tài sản. Tên tài nguyên thành phần có dạng:

customers/{customerId}/assets/{asset_id}
type

enum (AssetType)

Chỉ có đầu ra. Loại tài sản.
finalUrls[]

string

Danh sách các URL cuối cùng có thể xảy ra sau tất cả các lần chuyển hướng nhiều miền.
finalMobileUrls[]

string

Danh sách các URL cuối cùng trên thiết bị di động có thể có sau tất cả các lần chuyển hướng nhiều miền.
urlCustomParameters[]

object (CustomParameter)

Danh sách các ánh xạ được sử dụng để thay thế thẻ thông số tùy chỉnh URL trong trackUrlTemplate, lastUrls và/hoặc lastMobileUrls.
source

enum (AssetSource)

Chỉ có đầu ra. Nguồn của tài sản.
policySummary

object (AssetPolicySummary)

Chỉ có đầu ra. Thông tin chính sách cho nội dung.
fieldTypePolicySummaries[]

object (AssetFieldTypePolicySummary)

Chỉ có đầu ra. Thông tin chính sách cho nội dung cho từng TrườngType.
id

string (int64 format)

Chỉ có đầu ra. ID của nội dung.
name

string

Tên tài sản (không bắt buộc).
trackingUrlTemplate

string

Mẫu URL để tạo URL theo dõi.
finalUrlSuffix

string

Mẫu URL để thêm thông số vào URL trang đích được phân phát cùng với tính năng theo dõi song song.
Trường hợp asset_data. Loại nội dung cụ thể. asset_data chỉ có thể là một trong những trạng thái sau:
youtubeVideoAsset

object (YoutubeVideoAsset)

Không thể thay đổi. Tài sản video trên YouTube.
mediaBundleAsset

object (MediaBundleAsset)

Không thể thay đổi. Thành phần gói phương tiện.
imageAsset

object (ImageAsset)

Chỉ có đầu ra. Thành phần hình ảnh.
textAsset

object (TextAsset)

Không thể thay đổi. Thành phần văn bản.
leadFormAsset

object (LeadFormAsset)

Thành phần biểu mẫu khách hàng tiềm năng.
bookOnGoogleAsset

object (BookOnGoogleAsset)

Một cuốn sách trên tài sản của Google.
promotionAsset

object (PromotionAsset)

Thành phần chương trình khuyến mãi.
calloutAsset

object (CalloutAsset)

Thành phần chú thích.
structuredSnippetAsset

object (StructuredSnippetAsset)

Thành phần đoạn thông tin có cấu trúc.
pageFeedAsset

object (PageFeedAsset)

Thành phần nguồn cấp dữ liệu trang.
dynamicEducationAsset

object (DynamicEducationAsset)

Một thành phần linh động cho lĩnh vực giáo dục.
mobileAppAsset

object (MobileAppAsset)

Thành phần ứng dụng di động.
hotelCalloutAsset

object (HotelCalloutAsset)

Thành phần chú thích cho khách sạn.
callAsset

object (CallAsset)

Thành phần cuộc gọi.
priceAsset

object (PriceAsset)

Thành phần giá.
callToActionAsset

object (CallToActionAsset)

Không thể thay đổi. Thành phần lời kêu gọi hành động.
dynamicRealEstateAsset

object (DynamicRealEstateAsset)

Một tài sản linh động về bất động sản.
dynamicCustomAsset

object (DynamicCustomAsset)

Một thành phần tuỳ chỉnh linh động.
dynamicHotelsAndRentalsAsset

object (DynamicHotelsAndRentalsAsset)

Một thành phần linh động về khách sạn và nhà nghỉ cho thuê.
dynamicFlightsAsset

object (DynamicFlightsAsset)

Thành phần linh động về chuyến bay.
dynamicTravelAsset

object (DynamicTravelAsset)

Một thành phần linh động về du lịch.
dynamicLocalAsset

object (DynamicLocalAsset)

Một thành phần linh động tại địa phương.
dynamicJobsAsset

object (DynamicJobsAsset)

Một thành phần linh động về việc làm.
locationAsset

object (LocationAsset)

Chỉ có đầu ra. Thành phần địa điểm.
hotelPropertyAsset

object (HotelPropertyAsset)

Không thể thay đổi. Thành phần cơ sở lưu trú khách sạn.

AssetType

Enum mô tả các loại tài sản có thể sử dụng.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
YOUTUBE_VIDEO Tài sản video trên YouTube.
MEDIA_BUNDLE Thành phần gói phương tiện.
IMAGE Thành phần hình ảnh.
TEXT Thành phần văn bản.
LEAD_FORM Thành phần biểu mẫu khách hàng tiềm năng.
BOOK_ON_GOOGLE Tài sản Đặt phòng trên Google.
PROMOTION Thành phần chương trình khuyến mãi.
CALLOUT Thành phần chú thích.
STRUCTURED_SNIPPET Thành phần Đoạn thông tin có cấu trúc.
PAGE_FEED Thành phần Nguồn cấp dữ liệu trang.
DYNAMIC_EDUCATION thành phần Dynamic Education.
MOBILE_APP Thành phần ứng dụng di động.
HOTEL_CALLOUT Thành phần chú thích cho khách sạn.
CALL Thành phần cuộc gọi.
PRICE Thành phần giá.
CALL_TO_ACTION Thành phần lời kêu gọi hành động.
DYNAMIC_REAL_ESTATE Thành phần linh động về bất động sản.
DYNAMIC_CUSTOM Thành phần tuỳ chỉnh linh động.
DYNAMIC_HOTELS_AND_RENTALS Thành phần linh động về khách sạn và nhà nghỉ cho thuê.
DYNAMIC_FLIGHTS Thành phần linh động về chuyến bay.
DYNAMIC_TRAVEL Thành phần linh động về du lịch.
DYNAMIC_LOCAL Thành phần linh động tại địa phương.
DYNAMIC_JOBS Thành phần linh động về việc làm.
LOCATION Thành phần địa điểm.
HOTEL_PROPERTY Thành phần cơ sở lưu trú khách sạn.

AssetPolicySummary

Chứa thông tin chính sách của một nội dung.

Biểu diễn dưới dạng JSON 
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
Trường
policyTopicEntries[]

object (PolicyTopicEntry)

Chỉ có đầu ra. Danh sách các phát hiện liên quan đến chính sách cho nội dung này.
reviewStatus

enum (PolicyReviewStatus)

Chỉ có đầu ra. Vị trí của thành phần này trong quy trình xem xét.
approvalStatus

enum (PolicyApprovalStatus)

Chỉ có đầu ra. Trạng thái phê duyệt tổng thể của thành phần này, được tính dựa trên trạng thái của từng mục nhập chủ đề chính sách riêng lẻ.

AssetFieldTypePolicySummary

Chứa thông tin chính sách cho một nội dung trong ngữ cảnh AssetFieldType.

Biểu diễn dưới dạng JSON 
{
  "assetFieldType": enum (AssetFieldType),
  "assetSource": enum (AssetSource),
  "policySummaryInfo": {
    object (AssetPolicySummary)
  }
}
Trường
assetFieldType

enum (AssetFieldType)

Chỉ có đầu ra. Trường Loại của thành phần này.
assetSource

enum (AssetSource)

Chỉ có đầu ra. Nguồn của tài sản này.
policySummaryInfo

object (AssetPolicySummary)

Chỉ có đầu ra. Thông tin tóm tắt về chính sách.

YoutubeVideoAsset

Tài sản trên YouTube.

Biểu diễn dưới dạng JSON 
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
Trường
youtubeVideoTitle

string

Tiêu đề video trên YouTube.
youtubeVideoId

string

Mã video trên YouTube. Đây là giá trị chuỗi gồm 11 ký tự được sử dụng trong URL của video trên YouTube.

MediaBundleAsset

Một thành phần MediaBundle.

Biểu diễn dưới dạng JSON 
{
  "data": string
}
Trường
data

string (bytes format)

Dữ liệu thành phần gói phương tiện (tệp ZIP). Định dạng của tệp ZIP đã tải lên phụ thuộc vào trường quảng cáo sẽ sử dụng tệp này. Để biết thêm thông tin về định dạng này, hãy xem tài liệu về trường quảng cáo mà bạn dự định sử dụng MediaBundleAsset. Trường này chỉ có thể thay đổi.

Một chuỗi được mã hoá base64.

ImageAsset

Thành phần Hình ảnh.

Biểu diễn dưới dạng JSON 
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "data": string,
  "fileSize": string
}
Trường
mimeType

enum (MimeType)

Loại MIME của thành phần hình ảnh.
fullSize

object (ImageDimension)

Siêu dữ liệu cho hình ảnh này ở kích thước ban đầu.
data

string (bytes format)

Dữ liệu byte thô của một hình ảnh. Trường này chỉ có thể thay đổi.

Một chuỗi được mã hoá base64.
fileSize

string (int64 format)

Kích thước tệp của thành phần hình ảnh tính bằng byte.

ImageDimension

Siêu dữ liệu của hình ảnh ở một kích thước nhất định, có thể là bản gốc hoặc đã đổi kích thước.

Biểu diễn dưới dạng JSON 
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
Trường
heightPixels

string (int64 format)

Chiều cao của hình ảnh.
widthPixels

string (int64 format)

Chiều rộng của hình ảnh.
url

string

URL trả về hình ảnh có chiều cao và chiều rộng này.

TextAsset

Thành phần Văn bản.

Biểu diễn dưới dạng JSON 
{
  "text": string
}
Trường
text

string

Nội dung văn bản của thành phần văn bản.

LeadFormAsset

Thành phần Biểu mẫu khách hàng tiềm năng.

Biểu diễn dưới dạng JSON 
{
  "businessName": string,
  "callToActionType": enum (LeadFormCallToActionType),
  "callToActionDescription": string,
  "headline": string,
  "description": string,
  "privacyPolicyUrl": string,
  "fields": [
    {
      object (LeadFormField)
    }
  ],
  "customQuestionFields": [
    {
      object (LeadFormCustomQuestionField)
    }
  ],
  "deliveryMethods": [
    {
      object (LeadFormDeliveryMethod)
    }
  ],
  "postSubmitCallToActionType": enum (LeadFormPostSubmitCallToActionType),
  "desiredIntent": enum (LeadFormDesiredIntent),
  "postSubmitHeadline": string,
  "postSubmitDescription": string,
  "backgroundImageAsset": string,
  "customDisclosure": string
}
Trường
businessName

string

Bắt buộc. Tên của doanh nghiệp đang được quảng cáo.
callToActionType

enum (LeadFormCallToActionType)

Bắt buộc. Văn bản hiển thị được xác định trước khuyến khích người dùng mở rộng biểu mẫu.
callToActionDescription

string

Bắt buộc. Văn bản đưa ra tuyên bố giá trị rõ ràng về những gì người dùng mong đợi khi họ mở rộng biểu mẫu.
headline

string

Bắt buộc. Dòng tiêu đề của biểu mẫu mở rộng để mô tả những nội dung mà biểu mẫu này yêu cầu hoặc hỗ trợ.
description

string

Bắt buộc. Nội dung mô tả chi tiết về biểu mẫu mở rộng để mô tả những nội dung mà biểu mẫu yêu cầu hoặc hỗ trợ.
privacyPolicyUrl

string

Bắt buộc. Liên kết đến một trang mô tả chính sách về cách nhà quảng cáo/doanh nghiệp xử lý dữ liệu đã thu thập.
fields[]

object (LeadFormField)

Danh sách các trường nhập dữ liệu theo thứ tự. Bạn có thể cập nhật trường này bằng cách sắp xếp lại thứ tự các câu hỏi, nhưng không thể bằng cách thêm hoặc xoá câu hỏi.
customQuestionFields[]

object (LeadFormCustomQuestionField)

Danh sách các trường câu hỏi tuỳ chỉnh theo thứ tự. Trường này có giới hạn là 5 câu hỏi đủ điều kiện cho mỗi biểu mẫu.
deliveryMethods[]

object (LeadFormDeliveryMethod)

Các phương thức thiết lập để phân phối dữ liệu khách hàng tiềm năng đã thu thập cho nhà quảng cáo. Bạn chỉ có thể định cấu hình một phương thức đã nhập là Webhookdelivery.
postSubmitCallToActionType

enum (LeadFormPostSubmitCallToActionType)

Văn bản hiển thị được xác định trước khuyến khích người dùng hành động sau khi gửi biểu mẫu.
desiredIntent

enum (LeadFormDesiredIntent)

Ý định được chọn cho biểu mẫu khách hàng tiềm năng, ví dụ: số lượng nhiều hơn hoặc đủ tiêu chuẩn hơn.
postSubmitHeadline

string

Dòng tiêu đề là văn bản xuất hiện sau khi gửi biểu mẫu, trong đó mô tả cách nhà quảng cáo sẽ liên hệ với người dùng.
postSubmitDescription

string

Nội dung mô tả chi tiết hiển thị sau khi người dùng gửi biểu mẫu, trong đó mô tả cách nhà quảng cáo sẽ liên hệ với người dùng.
backgroundImageAsset

string

Tên tài nguyên thành phần của hình nền. Kích thước hình ảnh phải chính xác là 1200x628.
customDisclosure

string

Thông tin công bố tuỳ chỉnh xuất hiện cùng tuyên bố từ chối trách nhiệm của Google trên biểu mẫu khách hàng tiềm năng. Chỉ những khách hàng được cho phép mới truy cập được.

LeadFormCallToActionType

Enum mô tả loại cụm từ kêu gọi hành động trong biểu mẫu khách hàng tiềm năng.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
LEARN_MORE Tìm hiểu thêm.
GET_QUOTE Nhận thông tin báo giá.
APPLY_NOW Đăng ký ngay.
SIGN_UP Đăng ký.
CONTACT_US Liên hệ với chúng tôi.
SUBSCRIBE Đăng ký.
DOWNLOAD Tải xuống.
BOOK_NOW Đặt chỗ ngay.
GET_OFFER Nhận ưu đãi.
REGISTER Đăng ký.
GET_INFO Nhận thông tin.
REQUEST_DEMO Yêu cầu bản minh họa.
JOIN_NOW Tham gia ngay.
GET_STARTED Bắt đầu.

LeadFormField

Một thực thể của trường nhập dữ liệu trong một biểu mẫu.

Biểu diễn dưới dạng JSON 
{
  "inputType": enum (LeadFormFieldUserInputType),

  // Union field answers can be only one of the following:
  "singleChoiceAnswers": {
    object (LeadFormSingleChoiceAnswers)
  },
  "hasLocationAnswer": boolean
  // End of list of possible types for union field answers.
}
Trường
inputType

enum (LeadFormFieldUserInputType)

Mô tả loại thông tin đầu vào (có thể là loại được xác định trước, chẳng hạn như "tên đầy đủ" hoặc câu hỏi được xem xét kỹ lưỡng như "Bạn có loại xe nào?".
Trường hợp answers. Xác định cấu hình câu trả lời mà trường biểu mẫu này chấp nhận. Nếu một trong hai giá trị không được đặt, thì đây là câu trả lời dạng văn bản tự do. answers chỉ có thể là một trong những trạng thái sau:
singleChoiceAnswers

object (LeadFormSingleChoiceAnswers)

Cấu hình câu trả lời cho câu hỏi chỉ có một lựa chọn. Chỉ có thể đặt cho các trường câu hỏi đã được xem xét trước. Bạn phải đưa ra tối thiểu 2 câu trả lời và tối đa 12 câu trả lời.
hasLocationAnswer

boolean

Trả lời cấu hình cho câu hỏi về vị trí. Nếu đúng, dữ liệu vị trí ở cấp chiến dịch/tài khoản (tiểu bang, thành phố, tên doanh nghiệp, v.v.) sẽ hiển thị trên Biểu mẫu khách hàng tiềm năng. Kể từ phiên bản 13.1, bạn chỉ có thể đặt hasLocationAnswer cho câu hỏi "Bạn ưu tiên đại lý nào?" đối với những nhà quảng cáo đã thiết lập Thành phần địa điểm ở cấp chiến dịch/tài khoản.

LeadFormSingleChoiceAnswers

Xác định các câu trả lời có thể có cho câu hỏi chỉ có một lựa chọn, thường được trình bày dưới dạng danh sách thả xuống có một lựa chọn.

Biểu diễn dưới dạng JSON 
{
  "answers": [
    string
  ]
}
Trường
answers[]

string

Danh sách các lựa chọn cho một trường câu hỏi. Thứ tự của các mục nhập xác định thứ tự giao diện người dùng. Bạn phải đưa ra tối thiểu 2 câu trả lời và tối đa 12 câu trả lời.

LeadFormCustomQuestionField

Một trường hợp trường nhập câu hỏi tuỳ chỉnh trong một biểu mẫu.

Biểu diễn dưới dạng JSON 
{
  "customQuestionText": string,

  // Union field answers can be only one of the following:
  "singleChoiceAnswers": {
    object (LeadFormSingleChoiceAnswers)
  },
  "hasLocationAnswer": boolean
  // End of list of possible types for union field answers.
}
Trường
customQuestionText

string

Văn bản chính xác của trường câu hỏi tuỳ chỉnh (ví dụ: "Bạn có loại xe nào?").
Trường hợp answers. Xác định cấu hình câu trả lời mà trường biểu mẫu này chấp nhận. Nếu một trong hai giá trị không được đặt, thì đây là câu trả lời dạng văn bản tự do. answers chỉ có thể là một trong những trạng thái sau:
singleChoiceAnswers

object (LeadFormSingleChoiceAnswers)

Cấu hình câu trả lời cho câu hỏi chỉ có một lựa chọn. Bạn có thể đưa ra tối thiểu 2 câu trả lời và tối đa 12 câu trả lời.
hasLocationAnswer

boolean

Trả lời cấu hình cho câu hỏi về vị trí. Nếu đúng, dữ liệu vị trí ở cấp chiến dịch/tài khoản (tiểu bang, thành phố, tên doanh nghiệp, v.v.) sẽ hiển thị trên Biểu mẫu khách hàng tiềm năng. Kể từ phiên bản 13.1, bạn chỉ có thể đặt hasLocationAnswer cho câu hỏi "Bạn ưu tiên đại lý nào?" đối với những nhà quảng cáo đã thiết lập Thành phần địa điểm ở cấp chiến dịch/tài khoản.

LeadFormDeliveryMethod

Cấu hình cách phân phối khách hàng tiềm năng đến nhà quảng cáo.

Biểu diễn dưới dạng JSON 
{

  // Union field delivery_details can be only one of the following:
  "webhook": {
    object (WebhookDelivery)
  }
  // End of list of possible types for union field delivery_details.
}
Trường
Trường hợp delivery_details. Nhiều loại phân phối phụ. delivery_details chỉ có thể là một trong những trạng thái sau:
webhook

object (WebhookDelivery)

Phương thức phân phối webhook.

WebhookDelivery

Google thông báo cho nhà quảng cáo về khách hàng tiềm năng bằng cách thực hiện lệnh gọi HTTP tới điểm cuối mà họ chỉ định. Các yêu cầu này chứa JSON khớp với một giản đồ mà Google xuất bản trong tài liệu về quảng cáo biểu mẫu.

Biểu diễn dưới dạng JSON 
{
  "advertiserWebhookUrl": string,
  "googleSecret": string,
  "payloadSchemaVersion": string
}
Trường
advertiserWebhookUrl

string

URL webhook do nhà quảng cáo chỉ định để gửi khách hàng tiềm năng.
googleSecret

string

Bí mật chống giả mạo do nhà quảng cáo đặt trong tải trọng webhook.
payloadSchemaVersion

string (int64 format)

Phiên bản giản đồ mà thực thể phân phối này sẽ sử dụng.

LeadFormPostSubmitCallToActionType

Enum mô tả loại cụm từ kêu gọi hành động cho phần sau khi gửi biểu mẫu cho biểu mẫu khách hàng tiềm năng.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
VISIT_SITE Truy cập trang web.
DOWNLOAD Tải xuống.
LEARN_MORE Tìm hiểu thêm.
SHOP_NOW Mua ngay.

LeadFormDesiredIntent

Enum mô tả mức độ ý định chọn lọc của khách hàng tiềm năng đã tạo.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
LOW_INTENT Phân phối thêm nhiều khách hàng tiềm năng với chất lượng có thể thấp hơn.
HIGH_INTENT Cung cấp những khách hàng tiềm năng chất lượng hơn.

BookOnGoogleAsset

Loại này không có trường.

Một tài sản Đặt phòng trên Google. Dùng để chuyển hướng người dùng đặt phòng qua Google. Tính năng Đặt phòng trên Google sẽ thay đổi URL chuyển hướng để đặt phòng trực tiếp qua Google.

PromotionAsset

Thành phần Chương trình khuyến mãi.

Biểu diễn dưới dạng JSON 
{
  "promotionTarget": string,
  "discountModifier": enum (PromotionExtensionDiscountModifier),
  "redemptionStartDate": string,
  "redemptionEndDate": string,
  "occasion": enum (PromotionExtensionOccasion),
  "languageCode": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],

  // Union field discount_type can be only one of the following:
  "percentOff": string,
  "moneyAmountOff": {
    object (Money)
  }
  // End of list of possible types for union field discount_type.

  // Union field promotion_trigger can be only one of the following:
  "promotionCode": string,
  "ordersOverAmount": {
    object (Money)
  }
  // End of list of possible types for union field promotion_trigger.
}
Trường
promotionTarget

string

Bắt buộc. Nội dung mô tả dạng tự do về nội dung mà chương trình khuyến mãi nhắm đến.
discountModifier

enum (PromotionExtensionDiscountModifier)

Công cụ sửa đổi để đủ điều kiện hưởng chiết khấu.
redemptionStartDate

string

Ngày bắt đầu khi chương trình khuyến mãi đủ điều kiện sử dụng, ở định dạng yyyy-MM-dd.
redemptionEndDate

string

Ngày cuối cùng mà chương trình khuyến mãi đủ điều kiện sử dụng, ở định dạng yyyy-MM-dd.
occasion

enum (PromotionExtensionOccasion)

Dịp áp dụng chương trình khuyến mãi. Nếu bạn đặt một dịp, thì khoảng thời gian đổi thưởng cần phải nằm trong phạm vi ngày tương ứng với sự kiện đó.
languageCode

string

Ngôn ngữ của chương trình khuyến mãi. Được thể hiện dưới dạng thẻ ngôn ngữ BCP 47.
startDate

string

Ngày bắt đầu mà thành phần này có hiệu lực và có thể bắt đầu phân phát, ở định dạng yyyy-MM-dd.
endDate

string

Ngày cuối cùng mà thành phần này có hiệu lực và vẫn đang phân phát, ở định dạng yyyy-MM-dd.
adScheduleTargets[]

object (AdScheduleInfo)

Danh sách các lịch biểu không trùng lặp chỉ định tất cả các khoảng thời gian mà nội dung có thể phân phát. Có thể có tối đa 6 lịch biểu mỗi ngày, tổng cộng 42 lịch biểu.
Trường hợp discount_type. Loại chiết khấu, có thể là giảm giá theo phần trăm hoặc giảm giá. discount_type chỉ có thể là một trong những hình thức sau:
percentOff

string (int64 format)

Phần trăm chiết khấu trong chương trình khuyến mãi. 1.000.000 = 100%. Đây là yêu cầu bắt buộc phải có số tiền này hoặc amountAmountOff.
moneyAmountOff

object (Money)

Số tiền giảm giá trong chương trình khuyến mãi. Bạn phải áp dụng phần trăm chiết khấu hoặc phần trăm này.
Trường hợp promotion_trigger. Trình kích hoạt khuyến mãi. Có thể bằng mã khuyến mãi hoặc khuyến mãi theo số tiền hợp lệ của đơn đặt hàng. promotion_trigger chỉ có thể là một trong những trạng thái sau:
promotionCode

string

Mã mà người dùng phải sử dụng để đủ điều kiện tham gia chương trình khuyến mãi.
ordersOverAmount

object (Money)

Số tiền của tổng đơn đặt hàng cần đạt được để người dùng đủ điều kiện tham gia chương trình khuyến mãi.

CalloutAsset

Thành phần chú thích.

Biểu diễn dưới dạng JSON 
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ]
}
Trường
calloutText

string

Bắt buộc. Văn bản chú thích. Độ dài của chuỗi này phải nằm trong khoảng từ 1 đến 25.
startDate

string

Ngày bắt đầu mà thành phần này có hiệu lực và có thể bắt đầu phân phát, ở định dạng yyyy-MM-dd.
endDate

string

Ngày cuối cùng mà thành phần này có hiệu lực và vẫn đang phân phát, ở định dạng yyyy-MM-dd.
adScheduleTargets[]

object (AdScheduleInfo)

Danh sách các lịch biểu không trùng lặp chỉ định tất cả các khoảng thời gian mà nội dung có thể phân phát. Có thể có tối đa 6 lịch biểu mỗi ngày, tổng cộng 42 lịch biểu.

StructuredSnippetAsset

Thành phần Đoạn thông tin có cấu trúc.

Biểu diễn dưới dạng JSON 
{
  "header": string,
  "values": [
    string
  ]
}
Trường
header

string

Bắt buộc. Tiêu đề của đoạn thông tin. Chuỗi này phải là một trong các giá trị được xác định trước tại https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers
values[]

string

Bắt buộc. Các giá trị trong đoạn mã. Kích thước của bộ sưu tập này nên nằm trong khoảng từ 3 đến 10. Độ dài của mỗi giá trị phải từ 1 đến 25 ký tự, bao gồm cả hai giá trị này.

SitelinkAsset

Thành phần Đường liên kết của trang web.

Biểu diễn dưới dạng JSON 
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ]
}
Trường
linkText

string

Bắt buộc. Văn bản hiển thị URL cho đường liên kết của trang web. Độ dài của chuỗi này phải nằm trong khoảng từ 1 đến 25.
description1

string

Dòng đầu tiên của nội dung mô tả cho đường liên kết của trang web. Nếu đặt, độ dài phải nằm trong khoảng từ 1 đến 35, bao gồm cả phần mô tả và phần mô tả 2 cũng phải được đặt.
description2

string

Dòng thứ hai của nội dung mô tả cho đường liên kết của trang web. Nếu đặt, độ dài phải nằm trong khoảng từ 1 đến 35, và bạn cũng phải đặt description1.
startDate

string

Ngày bắt đầu mà thành phần này có hiệu lực và có thể bắt đầu phân phát, ở định dạng yyyy-MM-dd.
endDate

string

Ngày cuối cùng mà thành phần này có hiệu lực và vẫn đang phân phát, ở định dạng yyyy-MM-dd.
adScheduleTargets[]

object (AdScheduleInfo)

Danh sách các lịch biểu không trùng lặp chỉ định tất cả các khoảng thời gian mà nội dung có thể phân phát. Có thể có tối đa 6 lịch biểu mỗi ngày, tổng cộng 42 lịch biểu.

PageFeedAsset

Thành phần Nguồn cấp dữ liệu trang.

Biểu diễn dưới dạng JSON 
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
Trường
pageUrl

string

Bắt buộc. Trang web mà nhà quảng cáo muốn nhắm mục tiêu.
labels[]

string

Nhãn dùng để nhóm các URL trang.

DynamicEducationAsset

Một thành phần Dynamic Education.

Biểu diễn dưới dạng JSON 
{
  "programId": string,
  "locationId": string,
  "programName": string,
  "subject": string,
  "programDescription": string,
  "schoolName": string,
  "address": string,
  "contextualKeywords": [
    string
  ],
  "androidAppLink": string,
  "similarProgramIds": [
    string
  ],
  "iosAppLink": string,
  "iosAppStoreId": string,
  "thumbnailImageUrl": string,
  "imageUrl": string
}
Trường
programId

string

Bắt buộc. Mã chương trình có thể là bất kỳ chuỗi chữ cái và số nào, đồng thời phải là duy nhất và khớp với các giá trị của thẻ tiếp thị lại. Bắt buộc.
locationId

string

Mã vị trí có thể là một chuỗi chữ cái và số bất kỳ và phải là duy nhất.
programName

string

Bắt buộc. Tên chương trình, ví dụ: Cho con bú. Bắt buộc.
subject

string

Đối tượng nghiên cứu, ví dụ: Sức khoẻ.
programDescription

string

Nội dung mô tả chương trình, ví dụ: Chứng chỉ điều dưỡng.
schoolName

string

Tên trường học, ví dụ: Trường điều dưỡng Mountain View.
address

string

Địa chỉ trường học có thể được chỉ định ở một trong các định dạng sau. (1) Thành phố, tiểu bang, mã, quốc gia, ví dụ: Mountain View, CA, Hoa Kỳ. (2) Địa chỉ đầy đủ, ví dụ: 123 Boulevard St, Mountain View, CA 94043. (3) Kinh độ-vĩ độ ở định dạng DDD, ví dụ: 41.40338, 2.17403
contextualKeywords[]

string

Từ khoá theo ngữ cảnh (ví dụ: Chứng chỉ điều dưỡng, Sức khoẻ, Mountain View).
similarProgramIds[]

string

Mã chương trình tương tự.
iosAppStoreId

string (int64 format)

Mã cửa hàng ứng dụng iOS. Mã này dùng để kiểm tra xem người dùng đã cài đặt ứng dụng trên thiết bị của họ hay chưa trước khi bạn thêm đường liên kết sâu. Nếu bạn đặt trường này, thì cũng phải có trường iosAppLink.
thumbnailImageUrl

string

URL hình ảnh thu nhỏ, ví dụ: http://www.example.com/thumbnail.png. Hình thu nhỏ sẽ không được tải lên dưới dạng thành phần hình ảnh.
imageUrl

string

URL của hình ảnh, ví dụ: http://www.example.com/image.png. Hình ảnh sẽ không được tải lên dưới dạng thành phần hình ảnh.

MobileAppAsset

Một thành phần đại diện cho ứng dụng di động.

Biểu diễn dưới dạng JSON 
{
  "appId": string,
  "appStore": enum (MobileAppVendor),
  "linkText": string,
  "startDate": string,
  "endDate": string
}
Trường
appId

string

Bắt buộc. Một chuỗi xác định duy nhất một ứng dụng dành cho thiết bị di động. Tệp này chỉ nên chứa id gốc của nền tảng, chẳng hạn như "com.android.ebay" đối với Android hoặc "12345689" đối với iOS.
appStore

enum (MobileAppVendor)

Bắt buộc. Cửa hàng ứng dụng phân phối ứng dụng cụ thể này.
linkText

string

Bắt buộc. Văn bản xuất hiện khi đường liên kết xuất hiện trong quảng cáo. Độ dài của chuỗi này phải nằm trong khoảng từ 1 đến 25.
startDate

string

Ngày bắt đầu mà thành phần này có hiệu lực và có thể bắt đầu phân phát, ở định dạng yyyy-MM-dd.
endDate

string

Ngày cuối cùng mà thành phần này có hiệu lực và vẫn đang phân phát, ở định dạng yyyy-MM-dd.

HotelCalloutAsset

Thành phần đại diện cho chú thích cho khách sạn.

Biểu diễn dưới dạng JSON 
{
  "text": string,
  "languageCode": string
}
Trường
text

string

Bắt buộc. Văn bản của thành phần chú thích cho khách sạn. Độ dài của chuỗi này phải nằm trong khoảng từ 1 đến 25.
languageCode

string

Bắt buộc. Ngôn ngữ của chú thích cho khách sạn. Được thể hiện dưới dạng thẻ ngôn ngữ BCP 47.

CallAsset

Thành phần Cuộc gọi.

Biểu diễn dưới dạng JSON 
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ]
}
Trường
countryCode

string

Bắt buộc. Mã quốc gia gồm hai chữ cái của số điện thoại. Ví dụ: "US", "us".
phoneNumber

string

Bắt buộc. Số điện thoại thô của nhà quảng cáo. Ví dụ: "1234567890", "(123)456-7890"
callConversionReportingState

enum (CallConversionReportingState)

Cho biết liệu CallAsset này sẽ sử dụng chế độ cài đặt lượt chuyển đổi cuộc gọi riêng, tuân theo chế độ cài đặt cấp tài khoản hay tắt tính năng lượt chuyển đổi cuộc gọi.
callConversionAction

string

Hành động chuyển đổi để phân bổ lượt chuyển đổi dẫn đến cuộc gọi. Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng hành động chuyển đổi mặc định. Trường này chỉ có hiệu lực nếu callConversionReportingState được đặt thành USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION.
adScheduleTargets[]

object (AdScheduleInfo)

Danh sách các lịch biểu không trùng lặp chỉ định tất cả các khoảng thời gian mà nội dung có thể phân phát. Có thể có tối đa 6 lịch biểu mỗi ngày, tổng cộng 42 lịch biểu.

PriceAsset

Một thành phần đại diện cho danh sách các ưu đãi về giá.

Biểu diễn dưới dạng JSON 
{
  "type": enum (PriceExtensionType),
  "priceQualifier": enum (PriceExtensionPriceQualifier),
  "languageCode": string,
  "priceOfferings": [
    {
      object (PriceOffering)
    }
  ]
}
Trường
type

enum (PriceExtensionType)

Bắt buộc. Loại thành phần giá.
priceQualifier

enum (PriceExtensionPriceQualifier)

Bộ định giá của thành phần giá.
languageCode

string

Bắt buộc. Ngôn ngữ của thành phần giá. Được thể hiện dưới dạng thẻ ngôn ngữ BCP 47.
priceOfferings[]

object (PriceOffering)

Các đề xuất về giá của thành phần giá. Kích thước của bộ sưu tập này phải nằm trong khoảng từ 3 đến 8.

PriceOffering

Một sản phẩm cung cấp giá duy nhất trong một thành phần giá.

Biểu diễn dưới dạng JSON 
{
  "header": string,
  "description": string,
  "price": {
    object (Money)
  },
  "unit": enum (PriceExtensionPriceUnit),
  "finalUrl": string,
  "finalMobileUrl": string
}
Trường
header

string

Bắt buộc. Tiêu đề của nội dung cung cấp giá. Độ dài của chuỗi này phải nằm trong khoảng từ 1 đến 25.
description

string

Bắt buộc. Nội dung mô tả ưu đãi giá. Độ dài của chuỗi này phải nằm trong khoảng từ 1 đến 25.
price

object (Money)

Bắt buộc. Giá trị của sản phẩm đưa ra giá.
unit

enum (PriceExtensionPriceUnit)

Đơn vị giá của sản phẩm/dịch vụ cung cấp giá.
finalUrl

string

Bắt buộc. URL cuối cùng sau tất cả các lần chuyển hướng nhiều miền.
finalMobileUrl

string

URL cuối cùng trên thiết bị di động sau tất cả các lần chuyển hướng nhiều miền.

CallToActionAsset

Thành phần lời kêu gọi hành động.

Biểu diễn dưới dạng JSON 
{
  "callToAction": enum (CallToActionType)
}
Trường
callToAction

enum (CallToActionType)

Lời kêu gọi hành động.

DynamicRealEstateAsset

Một tài sản linh động về bất động sản.

Biểu diễn dưới dạng JSON 
{
  "listingId": string,
  "listingName": string,
  "cityName": string,
  "description": string,
  "address": string,
  "price": string,
  "imageUrl": string,
  "propertyType": string,
  "listingType": string,
  "contextualKeywords": [
    string
  ],
  "formattedPrice": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "similarListingIds": [
    string
  ]
}
Trường
listingId

string

Bắt buộc. Mã trang thông tin có thể là một chuỗi chữ cái và số bất kỳ, đồng thời phải là duy nhất và khớp với các giá trị của thẻ tái tiếp thị. Bắt buộc.
listingName

string

Bắt buộc. Tên trang thông tin, ví dụ: Boulevard Bungalow. Bắt buộc.
cityName

string

Tên thành phố, ví dụ: Mountain View, California.
description

string

Mô tả, ví dụ: 3 giường, 2 phòng tắm, 1568 bộ vuông.
address

string

Địa chỉ có thể được chỉ định bằng một trong các định dạng sau. (1) Thành phố, tiểu bang, mã, quốc gia, ví dụ: Mountain View, CA, Hoa Kỳ. (2) Địa chỉ đầy đủ, ví dụ: 123 Boulevard St, Mountain View, CA 94043. (3) Kinh độ-vĩ độ ở định dạng DDD, ví dụ: 41.40338, 2.17403
price

string

Giá có thể là số, theo sau là mã đơn vị tiền tệ dạng chữ cái, theo tiêu chuẩn ISO 4217. Sử dụng '.' làm dấu thập phân, ví dụ: 200.000.00 USD.
imageUrl

string

URL của hình ảnh, ví dụ: http://www.example.com/image.png. Hình ảnh sẽ không được tải lên dưới dạng thành phần hình ảnh.
propertyType

string

Loại tài sản, ví dụ: Nhà.
listingType

string

Loại trang thông tin, ví dụ: Để bán.
contextualKeywords[]

string

Từ khoá theo ngữ cảnh (ví dụ: Bán; Nhà rao bán).
formattedPrice

string

Giá được định dạng có thể là bất kỳ ký tự nào. Nếu bạn đặt thuộc tính này, thuộc tính này sẽ được sử dụng thay cho "price", chẳng hạn như Bắt đầu từ $200.000.
iosAppStoreId

string (int64 format)

Mã cửa hàng ứng dụng iOS. Mã này dùng để kiểm tra xem người dùng đã cài đặt ứng dụng trên thiết bị của họ hay chưa trước khi bạn thêm đường liên kết sâu. Nếu bạn đặt trường này, thì cũng phải có trường iosAppLink.
similarListingIds[]

string

ID danh sách tương tự.

DynamicCustomAsset

Một thành phần tuỳ chỉnh linh động.

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "id2": string,
  "itemTitle": string,
  "itemSubtitle": string,
  "itemDescription": string,
  "itemAddress": string,
  "itemCategory": string,
  "price": string,
  "salePrice": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "imageUrl": string,
  "contextualKeywords": [
    string
  ],
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "similarIds": [
    string
  ]
}
Trường
id

string

Bắt buộc. Mã nhận dạng có thể là một chuỗi chữ cái và chữ số bất kỳ, đồng thời phải là duy nhất và khớp với các giá trị của thẻ tiếp thị lại, ví dụ: xe sedan. Bắt buộc.
id2

string

Mã nhận dạng 2 có thể là một chuỗi chữ cái và chữ số bất kỳ, ví dụ: màu đỏ. Chuỗi mã nhận dạng (mã nhận dạng + mã nhận dạng 2) phải là duy nhất.
itemTitle

string

Bắt buộc. Tiêu đề mặt hàng, ví dụ: Xe sedan cỡ trung. Bắt buộc.
itemSubtitle

string

Tên phụ của mặt hàng, chẳng hạn như Tại đại lý Mountain View của bạn.
itemDescription

string

Nội dung mô tả mặt hàng, ví dụ: Chiếc ô tô cỡ trung bán chạy nhất.
itemAddress

string

Địa chỉ mặt hàng có thể được chỉ định ở một trong các định dạng sau. (1) Thành phố, tiểu bang, mã, quốc gia, ví dụ: Mountain View, CA, Hoa Kỳ. (2) Địa chỉ đầy đủ, ví dụ: 123 Boulevard St, Mountain View, CA 94043. (3) Kinh độ-vĩ độ ở định dạng DDD, ví dụ: 41.40338, 2.17403
itemCategory

string

Danh mục mặt hàng, ví dụ: xe sedan.
price

string

Giá có thể là số, theo sau là mã đơn vị tiền tệ dạng chữ cái, theo tiêu chuẩn ISO 4217. Sử dụng '.' làm dấu thập phân, ví dụ: 20.000 USD.
salePrice

string

Giá ưu đãi có thể là số, theo sau là mã đơn vị tiền tệ dạng chữ cái, theo tiêu chuẩn ISO 4217. Sử dụng '.' làm dấu thập phân, ví dụ: 15.000 USD. Phải nhỏ hơn trường "price".
formattedPrice

string

Giá được định dạng có thể là bất kỳ ký tự nào. Nếu bạn đặt thuộc tính này, thuộc tính này sẽ được sử dụng thay cho "price", chẳng hạn như Bắt đầu từ $20.000.
formattedSalePrice

string

Giá ưu đãi được định dạng có thể là ký tự bất kỳ. Nếu bạn đặt thuộc tính này, thuộc tính này sẽ được sử dụng thay cho "giá ưu đãi", ví dụ: Đang giảm giá với giá $15.000.
imageUrl

string

URL của hình ảnh, ví dụ: http://www.example.com/image.png. Hình ảnh sẽ không được tải lên dưới dạng thành phần hình ảnh.
contextualKeywords[]

string

Từ khoá theo ngữ cảnh (ví dụ: xe sedan, xe sedan 4 cửa).
iosAppStoreId

string (int64 format)

Mã cửa hàng ứng dụng iOS. Mã này dùng để kiểm tra xem người dùng đã cài đặt ứng dụng trên thiết bị của họ hay chưa trước khi bạn thêm đường liên kết sâu. Nếu bạn đặt trường này, thì cũng phải có trường iosAppLink.
similarIds[]

string

ID tương tự.

DynamicHotelsAndRentalsAsset

Một thành phần linh động về khách sạn và nhà nghỉ cho thuê.

Biểu diễn dưới dạng JSON 
{
  "propertyId": string,
  "propertyName": string,
  "imageUrl": string,
  "destinationName": string,
  "description": string,
  "price": string,
  "salePrice": string,
  "starRating": string,
  "category": string,
  "contextualKeywords": [
    string
  ],
  "address": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "similarPropertyIds": [
    string
  ]
}
Trường
propertyId

string

Bắt buộc. Mã tài sản có thể là một chuỗi chữ cái và số bất kỳ, đồng thời phải là duy nhất và khớp với các giá trị của thẻ tiếp thị lại. Bắt buộc.
propertyName

string

Bắt buộc. Tên cơ sở lưu trú, ví dụ: Khách sạn Mountain View. Bắt buộc.
imageUrl

string

URL của hình ảnh, ví dụ: http://www.example.com/image.png. Hình ảnh sẽ không được tải lên dưới dạng thành phần hình ảnh.
destinationName

string

Tên điểm đến, ví dụ: Trung tâm thành phố Mountain View.
description

string

Nội dung mô tả, ví dụ: Gần sân bay SJC.
price

string

Giá có thể là số, theo sau là mã đơn vị tiền tệ dạng chữ cái, theo tiêu chuẩn ISO 4217. Sử dụng "." làm dấu thập phân, ví dụ: 100.00 USD.
salePrice

string

Tiêu chuẩn ISO 4217. Sử dụng "." làm dấu thập phân, ví dụ: 80.00 USD. Phải nhỏ hơn trường "price".
starRating

string (int64 format)

Điểm xếp hạng theo sao. Phải là một số từ 1 đến 5, bao gồm cả 1 số từ 1 đến 5.
category

string

Danh mục, ví dụ: Bộ khách sạn.
contextualKeywords[]

string

Từ khoá theo ngữ cảnh (ví dụ: "Khách sạn" ở Mountain View), khách sạn ở South Bay.
address

string

Địa chỉ có thể được chỉ định bằng một trong các định dạng sau. (1) Thành phố, tiểu bang, mã, quốc gia, ví dụ: Mountain View, CA, Hoa Kỳ. (2) Địa chỉ đầy đủ, ví dụ: 123 Boulevard St, Mountain View, CA 94043. (3) Kinh độ-vĩ độ ở định dạng DDD, ví dụ: 41.40338, 2.17403
iosAppStoreId

string (int64 format)

Mã cửa hàng ứng dụng iOS. Mã này dùng để kiểm tra xem người dùng đã cài đặt ứng dụng trên thiết bị của họ hay chưa trước khi bạn thêm đường liên kết sâu. Nếu bạn đặt trường này, thì cũng phải có trường iosAppLink.
formattedPrice

string

Giá được định dạng có thể là bất kỳ ký tự nào. Nếu bạn đặt thuộc tính này, thuộc tính này sẽ được sử dụng thay cho "price", ví dụ: Bắt đầu từ $100.
formattedSalePrice

string

Giá ưu đãi được định dạng có thể là ký tự bất kỳ. Nếu bạn đặt thuộc tính này, thuộc tính này sẽ được sử dụng thay cho "giá ưu đãi", ví dụ: Giảm giá với giá 800.000 VND.
similarPropertyIds[]

string

ID thuộc tính tương tự.

DynamicFlightsAsset

Thành phần linh động về chuyến bay.

Biểu diễn dưới dạng JSON 
{
  "destinationId": string,
  "originId": string,
  "flightDescription": string,
  "imageUrl": string,
  "destinationName": string,
  "originName": string,
  "flightPrice": string,
  "flightSalePrice": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "similarDestinationIds": [
    string
  ],
  "customMapping": string
}
Trường
destinationId

string

Bắt buộc. Mã đích đến có thể là một chuỗi chữ cái và chữ số bất kỳ, đồng thời phải là duy nhất và khớp với các giá trị của thẻ tiếp thị lại. Bắt buộc.
originId

string

Mã điểm khởi hành có thể là một chuỗi chữ cái và chữ số bất kỳ. Chuỗi mã (mã đích đến + mã điểm khởi hành) phải là duy nhất.
flightDescription

string

Bắt buộc. Nội dung mô tả chuyến bay (ví dụ: Đặt vé). Bắt buộc.
imageUrl

string

URL của hình ảnh, ví dụ: http://www.example.com/image.png. Hình ảnh sẽ không được tải lên dưới dạng thành phần hình ảnh.
destinationName

string

Tên điểm đến, ví dụ: Paris.
originName

string

Tên điểm khởi hành, ví dụ: London.
flightPrice

string

Giá vé máy bay có thể là số, theo sau là mã đơn vị tiền tệ dạng chữ cái, theo tiêu chuẩn ISO 4217. Sử dụng "." làm dấu thập phân, ví dụ: 100.00 USD.
flightSalePrice

string

Giá ưu đãi của chuyến bay có thể là số, theo sau là mã đơn vị tiền tệ dạng chữ cái, theo tiêu chuẩn ISO 4217. Sử dụng "." làm dấu thập phân, ví dụ: 80.00 USD. Phải nhỏ hơn trường "flightPrice".
formattedPrice

string

Giá được định dạng có thể là bất kỳ ký tự nào. Nếu bạn đặt thuộc tính này, thuộc tính này sẽ được sử dụng thay cho "price", ví dụ: Bắt đầu từ $100.
formattedSalePrice

string

Giá ưu đãi được định dạng có thể là ký tự bất kỳ. Nếu bạn đặt thuộc tính này, thuộc tính này sẽ được sử dụng thay cho "giá ưu đãi", ví dụ: Giảm giá với giá 800.000 VND.
iosAppStoreId

string (int64 format)

Mã cửa hàng ứng dụng iOS. Mã này dùng để kiểm tra xem người dùng đã cài đặt ứng dụng trên thiết bị của họ hay chưa trước khi bạn thêm đường liên kết sâu. Nếu bạn đặt trường này, thì cũng phải có trường iosAppLink.
similarDestinationIds[]

string

Mã điểm đến tương tự, ví dụ: PAR,LON.
customMapping

string

Một trường tuỳ chỉnh có thể chứa nhiều khoá cho mục ánh xạ giá trị được phân tách bằng dấu phân cách (",", "|" và ":"), ở dạng ": , , ... , | : , ... , | ... | : , ... ," chẳng hạn như wifi: nhất | máy bay: 320, 77W | chuyến bay: 42, 77W | chuyến bay: 42 | Chỗ để chân: 3{/1

DiscoveryCarouselCardAsset

Tài sản Thẻ băng chuyền của quảng cáo Khám phá.

Biểu diễn dưới dạng JSON 
{
  "marketingImageAsset": string,
  "squareMarketingImageAsset": string,
  "portraitMarketingImageAsset": string,
  "headline": string,
  "callToActionText": string
}
Trường
marketingImageAsset

string

Tên tài nguyên thành phần của hình ảnh tiếp thị 1,91:1 được liên kết. Thành phần này và/hoặc hình ảnh tiếp thị hình vuông là bắt buộc.
squareMarketingImageAsset

string

Tên tài nguyên thành phần của hình ảnh tiếp thị hình vuông được liên kết. Bạn phải có thành phần này và/hoặc thành phần hình ảnh tiếp thị.
portraitMarketingImageAsset

string

Tên tài nguyên thành phần của hình ảnh tiếp thị dọc tỷ lệ 4:5 được liên kết.
headline

string

Bắt buộc. Dòng tiêu đề của thẻ băng chuyền.
callToActionText

string

Nội dung lời kêu gọi hành động.

DynamicTravelAsset

Một thành phần linh động về du lịch.

Biểu diễn dưới dạng JSON 
{
  "destinationId": string,
  "originId": string,
  "title": string,
  "destinationName": string,
  "destinationAddress": string,
  "originName": string,
  "price": string,
  "salePrice": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "category": string,
  "contextualKeywords": [
    string
  ],
  "similarDestinationIds": [
    string
  ],
  "imageUrl": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string
}
Trường
destinationId

string

Bắt buộc. Mã đích đến có thể là một chuỗi chữ cái và chữ số bất kỳ, đồng thời phải là duy nhất và khớp với các giá trị của thẻ tiếp thị lại. Bắt buộc.
originId

string

Mã điểm khởi hành có thể là một chuỗi chữ cái và chữ số bất kỳ. Chuỗi mã (mã đích đến + mã điểm khởi hành) phải là duy nhất.
title

string

Bắt buộc. Tiêu đề, ví dụ: Đặt vé tàu. Bắt buộc.
destinationName

string

Tên điểm đến, ví dụ: Paris.
destinationAddress

string

Địa chỉ điểm đến có thể được chỉ định ở một trong các định dạng sau. (1) Thành phố, tiểu bang, mã, quốc gia, ví dụ: Mountain View, CA, Hoa Kỳ. (2) Địa chỉ đầy đủ, ví dụ: 123 Boulevard St, Mountain View, CA 94043. (3) Vĩ độ-kinh độ ở định dạng DDD, ví dụ: 41,40338, 2,17403.
originName

string

Tên điểm khởi hành, ví dụ: London.
price

string

Giá có thể là một số theo sau là mã đơn vị tiền tệ dạng chữ cái, theo tiêu chuẩn ISO 4217. Sử dụng "." làm dấu thập phân, ví dụ: 100.00 USD.
salePrice

string

Giá ưu đãi có thể là một con số, theo sau là mã đơn vị tiền tệ dạng chữ cái, theo tiêu chuẩn ISO 4217. Sử dụng "." làm dấu thập phân, ví dụ: 80.00 USD. Phải nhỏ hơn trường "price".
formattedPrice

string

Giá được định dạng có thể là bất kỳ ký tự nào. Nếu bạn đặt thuộc tính này, thuộc tính này sẽ được sử dụng thay cho "price", ví dụ: Bắt đầu từ $100.
formattedSalePrice

string

Giá ưu đãi được định dạng có thể là ký tự bất kỳ. Nếu bạn đặt thuộc tính này, thuộc tính này sẽ được sử dụng thay cho "giá ưu đãi", ví dụ: Giảm giá với giá 800.000 VND.
category

string

Danh mục, ví dụ: Sao lưu nhanh.
contextualKeywords[]

string

Từ khoá theo ngữ cảnh, ví dụ: tàu hoả ở Paris.
similarDestinationIds[]

string

Mã điểm đến tương tự, ví dụ: NYC.
imageUrl

string

URL của hình ảnh, ví dụ: http://www.example.com/image.png. Hình ảnh sẽ không được tải lên dưới dạng thành phần hình ảnh.
iosAppStoreId

string (int64 format)

Mã cửa hàng ứng dụng iOS. Mã này dùng để kiểm tra xem người dùng đã cài đặt ứng dụng trên thiết bị của họ hay chưa trước khi bạn thêm đường liên kết sâu. Nếu bạn đặt trường này, thì cũng phải có trường iosAppLink.

DynamicLocalAsset

Một thành phần linh động tại địa phương.

Biểu diễn dưới dạng JSON 
{
  "dealId": string,
  "dealName": string,
  "subtitle": string,
  "description": string,
  "price": string,
  "salePrice": string,
  "imageUrl": string,
  "address": string,
  "category": string,
  "contextualKeywords": [
    string
  ],
  "formattedPrice": string,
  "formattedSalePrice": string,
  "androidAppLink": string,
  "similarDealIds": [
    string
  ],
  "iosAppLink": string,
  "iosAppStoreId": string
}
Trường
dealId

string

Bắt buộc. Mã giao dịch có thể là bất kỳ chuỗi chữ cái và chữ số nào, đồng thời phải là duy nhất và khớp với các giá trị của thẻ tiếp thị lại. Bắt buộc.
dealName

string

Bắt buộc. Tên ưu đãi, ví dụ: giảm giá 50% tại Cửa hàng tạp hoá Mountain View. Bắt buộc.
subtitle

string

Tiêu đề phụ, ví dụ: Hàng tạp hoá.
description

string

Nội dung mô tả, ví dụ: Tiết kiệm trên hoá đơn hằng tuần của bạn.
price

string

Giá có thể là một số theo sau là mã đơn vị tiền tệ dạng chữ cái, theo tiêu chuẩn ISO 4217. Sử dụng "." làm dấu thập phân, ví dụ: 100.00 USD.
salePrice

string

Giá ưu đãi có thể là số, theo sau là mã đơn vị tiền tệ dạng chữ cái, theo tiêu chuẩn ISO 4217. Sử dụng "." làm dấu thập phân, ví dụ: 80.00 USD. Phải nhỏ hơn trường "price".
imageUrl

string

URL của hình ảnh, ví dụ: http://www.example.com/image.png. Hình ảnh sẽ không được tải lên dưới dạng thành phần hình ảnh.
address

string

Địa chỉ có thể được chỉ định bằng một trong các định dạng sau. (1) Thành phố, tiểu bang, mã, quốc gia, ví dụ: Mountain View, CA, Hoa Kỳ. (2) Địa chỉ đầy đủ, ví dụ: 123 Boulevard St, Mountain View, CA 94043. (3) Vĩ độ-kinh độ ở định dạng DDD, ví dụ: 41,40338, 2,17403.
category

string

Danh mục, ví dụ: Thực phẩm.
contextualKeywords[]

string

Từ khoá theo ngữ cảnh, ví dụ: Lưu phiếu giảm giá hàng tạp hoá.
formattedPrice

string

Giá được định dạng có thể là bất kỳ ký tự nào. Nếu bạn đặt thuộc tính này, thuộc tính này sẽ được sử dụng thay cho "price", ví dụ: Bắt đầu từ $100.
formattedSalePrice

string

Giá ưu đãi được định dạng có thể là ký tự bất kỳ. Nếu bạn đặt thuộc tính này, thuộc tính này sẽ được sử dụng thay cho "giá ưu đãi", ví dụ: Giảm giá với giá 800.000 VND.
similarDealIds[]

string

Mã giao dịch tương tự, ví dụ: 1275.
iosAppStoreId

string (int64 format)

Mã cửa hàng ứng dụng iOS. Mã này dùng để kiểm tra xem người dùng đã cài đặt ứng dụng trên thiết bị của họ hay chưa trước khi bạn thêm đường liên kết sâu. Nếu bạn đặt trường này, thì cũng phải có trường iosAppLink.

DynamicJobsAsset

Một thành phần linh động về việc làm.

Biểu diễn dưới dạng JSON 
{
  "jobId": string,
  "locationId": string,
  "jobTitle": string,
  "jobSubtitle": string,
  "description": string,
  "imageUrl": string,
  "jobCategory": string,
  "contextualKeywords": [
    string
  ],
  "address": string,
  "salary": string,
  "androidAppLink": string,
  "similarJobIds": [
    string
  ],
  "iosAppLink": string,
  "iosAppStoreId": string
}
Trường
jobId

string

Bắt buộc. Mã công việc có thể là một chuỗi chữ cái và chữ số bất kỳ, đồng thời phải là duy nhất và khớp với các giá trị của thẻ tiếp thị lại. Bắt buộc.
locationId

string

Mã vị trí có thể là một chuỗi chữ cái và số bất kỳ. Chuỗi mã (mã công việc + mã vị trí) phải là duy nhất.
jobTitle

string

Bắt buộc. Chức danh, ví dụ: Kỹ sư phần mềm. Bắt buộc.
jobSubtitle

string

Chức danh phụ, ví dụ: Cấp II.
description

string

Nội dung mô tả (ví dụ: Áp dụng kỹ năng kỹ thuật).
imageUrl

string

URL của hình ảnh, ví dụ: http://www.example.com/image.png. Hình ảnh sẽ không được tải lên dưới dạng thành phần hình ảnh.
jobCategory

string

Danh mục công việc, ví dụ: Kỹ thuật.
contextualKeywords[]

string

Từ khoá theo ngữ cảnh (ví dụ: công việc kỹ thuật phần mềm).
address

string

Địa chỉ có thể được chỉ định bằng một trong các định dạng sau. (1) Thành phố, tiểu bang, mã, quốc gia, ví dụ: Mountain View, CA, Hoa Kỳ. (2) Địa chỉ đầy đủ, ví dụ: 123 Boulevard St, Mountain View, CA 94043. (3) Vĩ độ-kinh độ ở định dạng DDD, ví dụ: 41,40338, 2,17403.
salary

string

Lương, ví dụ: 100.000 đô la.
similarJobIds[]

string

Mã công việc tương tự, ví dụ: 1275.
iosAppStoreId

string (int64 format)

Mã cửa hàng ứng dụng iOS. Mã này dùng để kiểm tra xem người dùng đã cài đặt ứng dụng trên thiết bị của họ hay chưa trước khi bạn thêm đường liên kết sâu. Nếu bạn đặt trường này, thì cũng phải có trường iosAppLink.

LocationAsset

Thành phần địa điểm.

Biểu diễn dưới dạng JSON 
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
Trường
placeId

string

Mã địa điểm xác định duy nhất một địa điểm trong cơ sở dữ liệu Google Địa điểm và trên Google Maps. Trường này là dành riêng cho một mã khách hàng và loại thành phần nhất định. Xem https://developers.google.com/places/web-service/place-id để tìm hiểu thêm về Mã địa điểm.
businessProfileLocations[]

object (BusinessProfileLocation)

Danh sách địa điểm doanh nghiệp của khách hàng. Hệ thống sẽ chỉ trả về giá trị này nếu Thành phần địa điểm đang đồng bộ hoá từ tài khoản Trang doanh nghiệp. Bạn có thể có nhiều trang thông tin Trang doanh nghiệp trong cùng một tài khoản trỏ đến cùng một Mã địa điểm.
locationOwnershipType

enum (LocationOwnershipType)

Loại quyền sở hữu vị trí. Nếu loại doanh nghiệp là BUSINESS_OWNER, loại doanh nghiệp này sẽ được phân phát dưới dạng phần mở rộng về địa điểm. Nếu loại là AFFLIATE, loại sản phẩm này sẽ được phân phát dưới dạng vị trí của đơn vị liên kết.

BusinessProfileLocation

Dữ liệu vị trí của Trang doanh nghiệp được đồng bộ hoá từ tài khoản Trang doanh nghiệp đã liên kết.

Biểu diễn dưới dạng JSON 
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
Trường
labels[]

string

Nhãn do nhà quảng cáo chỉ định cho vị trí trên tài khoản Trang doanh nghiệp. Thông tin này được đồng bộ hoá từ tài khoản Trang doanh nghiệp.
storeCode

string

Mã cửa hàng trên Trang doanh nghiệp của vị trí này. Thông tin này được đồng bộ hoá từ tài khoản Trang doanh nghiệp.
listingId

string (int64 format)

Mã trang thông tin của vị trí trên Trang doanh nghiệp này. Thông tin này được đồng bộ hoá từ tài khoản Trang doanh nghiệp đã liên kết.

HotelPropertyAsset

Thành phần cơ sở lưu trú khách sạn.

Biểu diễn dưới dạng JSON 
{
  "placeId": string,
  "hotelAddress": string,
  "hotelName": string
}
Trường
placeId

string

Mã địa điểm xác định duy nhất một địa điểm trong cơ sở dữ liệu Google Địa điểm và trên Google Maps. Hãy tham khảo https://developers.google.com/places/web-service/place-id để tìm hiểu thêm.
hotelAddress

string

Địa chỉ của khách sạn. Chỉ đọc.
hotelName

string

Tên khách sạn. Chỉ đọc.