Asset

Thành phần là một phần của một quảng cáo và có thể được chia sẻ trên nhiều quảng cáo. Đó có thể là hình ảnh (ImageAsset), video (YoutubeVideoAsset), v.v. Các thành phần là không thể thay đổi và không thể xoá. Để ngừ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

Bất biến. Tên tài nguyên của thành phầ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 thành phần.
finalUrls[]

string

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

string

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

object (CustomParameter)

Danh sách các mối liên kết được dùng để thay thế thẻ tham số tuỳ chỉnh URL trong trackingUrlTemplate, finalUrls và/hoặc finalMobileUrls.
source

enum (AssetSource)

Chỉ có đầu ra. Nguồn của thành phần.
policySummary

object (AssetPolicySummary)

Chỉ có đầu ra. Thông tin về chính sách đối với tài sản.
fieldTypePolicySummaries[]

object (AssetFieldTypePolicySummary)

Chỉ có đầu ra. Thông tin chính sách cho thành phần đối với mỗi FieldType.
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 các thông số vào URL trang đích được phân phát thông qua tính năng theo dõi song song.
Trường hợp hợp nhất asset_data. Loại tài sản cụ thể. asset_data chỉ có thể là một trong những trạng thái sau đây:
youtubeVideoAsset

object (YoutubeVideoAsset)

Bất biến. Thành phần video trên YouTube.
mediaBundleAsset

object (MediaBundleAsset)

Không thể thay đổi. Thành phần gói nội dung nghe nhì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)

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

object (BookOnGoogleAsset)

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 về 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 bất động sản linh động.
dynamicCustomAsset

object (DynamicCustomAsset)

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)

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

object (DynamicLocalAsset)

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

object (DynamicJobsAsset)

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)

Bất biến. 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ể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
YOUTUBE_VIDEO Nội dung 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 của tính năng Đặ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 động về giáo dục.
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ề công việc.
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 về chính sách cho một tài sản.

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 về chính sách đối với tài sản này.
reviewStatus

enum (PolicyReviewStatus)

Chỉ có đầu ra. Vị trí của thành phần này trong quá 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 về chính sách đối với một thành phần 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. FieldType của thành phần này.
assetSource

enum (AssetSource)

Chỉ có đầu ra. Nguồn của thành phần này.
policySummaryInfo

object (AssetPolicySummary)

Chỉ có đầu ra. Tóm tắt 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 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 mà tệp sẽ được sử dụng. Để 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.

Chuỗi được mã hoá base64.

ImageAsset

Một 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 gốc.
data

string (bytes format)

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

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 về hình ảnh ở một kích thước nhất định, dù là 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

Một 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ả nội dung mà biểu mẫu 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 gì biểu mẫu yêu cầu hoặc hỗ trợ.
privacyPolicyUrl

string

Bắt buộc. Đường 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 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 các câu hỏi, nhưng không thể thêm hoặc xoá câu hỏi.
customQuestionFields[]

object (LeadFormCustomQuestionField)

Danh sách theo thứ tự của các trường câu hỏi tuỳ chỉnh. Trường này có giới hạn 5 câu hỏi xác định đ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 về 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 được nhập dưới dạng 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 biểu mẫu được gửi.
desiredIntent

enum (LeadFormDesiredIntent)

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

string

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

string

Nội dung mô tả chi tiết xuất hiện sau khi khách hàng gửi biểu mẫu để 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 với 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 có thể truy cập.

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ề. Biểu thị 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 Hãy 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 hoạ.
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 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 dữ liệu đầu vào, có thể là loại được xác định trước, chẳng hạn như "họ tên" hoặc một câu hỏi được xem xét kỹ lưỡng như "Bạn có loại xe nào?".
Trường kết 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ị chưa được đặt, thì đây là câu trả lời dạng văn bản tuỳ ý. answers chỉ có thể là một trong những trạng thái sau đây:
singleChoiceAnswers

object (LeadFormSingleChoiceAnswers)

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

boolean

Cấu hình câu trả lời 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ẽ được 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 "Đại lý nào bạn muốn ưu tiên?" đối với những nhà quảng cáo thiết lập Thành phần vị trí ở 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 dạng 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ự trên giao diện người dùng. Cần có tối thiểu 2 câu trả lời và cho phép tối đa 12 câu trả lời.

LeadFormCustomQuestionField

Một phiên bản trường nhập câu hỏi tuỳ chỉnh trong 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 hợp nhất 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 các giá trị chưa được đặt, thì đây là câu trả lời dạng văn bản tuỳ ý. answers chỉ có thể là một trong những giá trị sau:
singleChoiceAnswers

object (LeadFormSingleChoiceAnswers)

Cấu hình câu trả lời cho câu hỏi một lựa chọn. Cho phép tối thiểu 2 câu trả lời và tối đa 12 câu trả lời.
hasLocationAnswer

boolean

Cấu hình câu trả lời cho câu hỏi về vị trí. Nếu đúng, thì 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ẽ xuất hiện trên Biểu mẫu khách hàng tiềm năng. Kể từ phiên bản 13.1, chỉ 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 mới có thể đặt hasLocationAnswer cho câu hỏi "Bạn ưa thích đại lý nào?".

LeadFormDeliveryMethod

Cấu hình về cách phân phối khách hàng tiềm năng cho 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 hợp nhất delivery_details. Nhiều loại phụ của phương thức phân phối. delivery_details chỉ có thể là một trong những giá trị 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 các lệnh gọi HTTP đến một đ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

Khoá 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à phiên bản phân phối này sẽ sử dụng.

LeadFormPostSubmitCallToActionType

Enum mô tả các loại cụm từ kêu gọi hành động sau khi gửi 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ề. Biểu thị giá trị không xác định trong phiên bản này.
VISIT_SITE Truy cập vào 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 của khách hàng tiềm năng được tạo.

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

BookOnGoogleAsset

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

Một thành phần của tính năng Đặt phòng trên Google. Dùng để chuyển hướng người dùng đến trang đặt phòng thô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 thông 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ề đối tượng 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 tính từ thời điểm chương trình khuyến mãi đủ điều kiện sử dụng, theo định dạng yyyy-MM-dd.
redemptionEndDate

string

Ngày cuối cùng mà bạn có thể sử dụng chương trình khuyến mãi, ở định dạng yyyy-MM-dd.
occasion

enum (PromotionExtensionOccasion)

Dịp khuyến mãi. Nếu bạn đặt một dịp, thời gian đổi thưởng cần phải nằm trong phạm vi ngày được liên kết với sự kiện đó.
languageCode

string

Nội dung quảng cáo. Được biểu thị 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 phân phát, ở định dạng yyyy-MM-dd.
adScheduleTargets[]

object (AdScheduleInfo)

Danh sách lịch không trùng lặp chỉ định tất cả khoảng thời gian mà thành phần 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 kết hợp discount_type. Loại chiết khấu, có thể là tỷ lệ phần trăm giảm giá hoặc số tiền giảm giá. discount_type chỉ có thể là một trong những loại sau:
percentOff

string (int64 format)

Mức chiết khấu theo tỷ lệ phần trăm trong chương trình khuyến mãi. 1.000.000 = 100%. Bạn phải cung cấp thuộc tính này hoặc moneyAmountOff.
moneyAmountOff

object (Money)

Số tiền giảm giá trong chương trình khuyến mãi. Bạn phải cung cấp giá trị này hoặc percentOff.
Trường kết hợp promotion_trigger. Điều kiện kích hoạt chương trình khuyến mãi. Có thể là theo mã khuyến mãi hoặc khuyến mãi theo số tiền đặt hàng đủ điều kiện. promotion_trigger chỉ có thể là một trong những giá trị 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)

Tổng số tiền của đơn đặt hàng để người dùng đủ điều kiện nhận ưu đã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 phân phát, ở định dạng yyyy-MM-dd.
adScheduleTargets[]

object (AdScheduleInfo)

Danh sách lịch biểu không chồng chéo xác định tất cả các khoảng thời gian mà nội dung có thể phân phát. Bạn có thể tạo 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 mã. 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 phải nằm trong khoảng từ 3 đến 10. Độ dài của mỗi giá trị phải nằm trong khoảng từ 1 đến 25 ký tự.

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 liên kết 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 trong nội dung mô tả cho đường liên kết của trang web. Nếu được đặt, độ dài phải nằm trong khoảng từ 1 đến 35, bao gồm cả 2 và bạn cũng phải đặt description2.
description2

string

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

string

Ngày bắt đầu áp dụng và có thể bắt đầu phân phát thành phần này, ở đị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 phân phát, ở định dạng yyyy-MM-dd.
adScheduleTargets[]

object (AdScheduleInfo)

Danh sách lịch biểu không chồng chéo xác định tất cả các khoảng thời gian mà nội dung có thể phân phát. Bạn có thể tạo 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 đến.
labels[]

string

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

DynamicEducationAsset

Thành phần linh động về Giáo dục.

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ẻ tái tiếp thị. Bắt buộc.
locationId

string

Mã vị trí 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.
programName

string

Bắt buộc. Tên chương trình, ví dụ: Điều dưỡng. Bắt buộc.
subject

string

Chủ đề 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, ví dụ: Trường điều dưỡng Mountain View.
address

string

Địa chỉ trường học 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
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ì trường iosAppLink cũng phải có.
thumbnailImageUrl

string

Ví dụ: URL hình ảnh hình thu nhỏ 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 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 nhận dạng duy nhất một ứng dụng di động. Mã này chỉ được chứa mã nhận dạng gốc của nền tảng, chẳng hạn như "com.android.ebay" cho Android hoặc "12345689" cho 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 hiển thị xuất hiện khi đường liên kết được hiển thị 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

Một thành phần đại diện cho chú thích về 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 biểu thị 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 có nên 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 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, thì hành động chuyển đổi mặc định sẽ được sử dụng. Trường này chỉ có hiệu lực nếu gọi
adScheduleTargets[]

object (AdScheduleInfo)

Danh sách lịch biểu không chồng chéo xác đị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 một danh sách các ưu đãi 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 biểu thị dưới dạng thẻ ngôn ngữ BCP 47.
priceOfferings[]

object (PriceOffering)

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 mức giá trong PriceAsset.

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 thông tin đề xuất 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ả về mức 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ị giá của mặt hàng.
unit

enum (PriceExtensionPriceUnit)

Đơn vị giá của mặt hàng.
finalUrl

string

Bắt buộc. URL cuối cùng sau tất cả các lần chuyển hướng giữa 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 giữa 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 bất động sản linh động.

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ã danh sách có thể là 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 giá trị của thẻ tiếp thị lại. 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

Thông tin mô tả, ví dụ: 3 giường, 2 phòng tắm, 1568 m2.
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
price

string

Giá có thể bằng 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 dấu "." 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ụ: Đang bán.
contextualKeywords[]

string

Từ khoá theo ngữ cảnh, ví dụ: Để bán; Nhà cần bán.
formattedPrice

string

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

string (int64 format)

ID 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ì trường iosAppLink cũng phải có.
similarListingIds[]

string

Mã trang thông tin tương tự.

DynamicCustomAsset

Một thành phần tuỳ chỉnh độ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ã có thể là 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 giá trị của thẻ tái tiếp thị (ví dụ: xe sedan). Bắt buộc.
id2

string

Mã nhận dạng 2 có thể là bất kỳ chuỗi chữ cái và số nào, ví dụ: đỏ. Chuỗi mã nhận dạng (ID + ID2) 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

Phụ đề của mặt hàng, ví dụ: Tại đại lý của bạn ở Mountain View.
itemDescription

string

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

string

Địa chỉ mặt hàng 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
itemCategory

string

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

string

Giá có thể bằng 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ố đứng trước mã đơn vị tiền tệ dạng chữ cái, theo tiêu chuẩn ISO 4217. Sử dụng dấu "." làm dấu thập phân, ví dụ: 15.000.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 được đặt, thuộc tính này sẽ được sử dụng thay vì "price" (giá), ví dụ: Kể từ 20.000 đô la Mỹ.
formattedSalePrice

string

Giá ưu đãi được định dạng, có thể là bất kỳ ký tự nào. Nếu được đặt, thuộc tính này sẽ được sử dụng thay cho "giá ưu đãi", ví dụ: Giảm giá còn 15.000 đô la Mỹ.
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)

ID 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ì trường iosAppLink cũng phải có.
similarIds[]

string

Mã nhận dạng tương tự.

DynamicHotelsAndRentalsAsset

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à 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ẻ tái tiếp thị. 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ể bằng 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ụ: 1000000.00 VND.
salePrice

string

Tiêu chuẩn ISO 4217. Sử dụng dấu "." 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.
category

string

Danh mục, ví dụ: Phòng 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) Vĩ độ – kinh độ ở định dạng DDD, ví dụ: 41.40338, 2.17403
iosAppStoreId

string (int64 format)

ID 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ì trường iosAppLink cũng phải xuất hiện.
formattedPrice

string

Giá được định dạng có thể là bất kỳ ký tự nào. Nếu được đặt, thuộc tính này sẽ được sử dụng thay vì "price" (giá), ví dụ: Kể từ 100.000 VND.
formattedSalePrice

string

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

string

Mã cơ sở lưu trú tương tự.

DynamicFlightsAsset

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

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 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ẻ tái tiếp thị. 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ã nhận dạng (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 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 xuất phát, ví dụ: London.
flightPrice

string

Giá vé máy bay có thể là số đứng trước mã đơn vị tiền tệ dạng chữ cái, theo tiêu chuẩn ISO 4217. Sử dụng dấu "." 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ể bằng 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ụ: 800000.00 VND. 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 được đặt, thuộc tính này sẽ được sử dụng thay cho "price", ví dụ: Giá từ 100 USD.
formattedSalePrice

string

Giá ưu đãi được định dạng, có thể là bất kỳ ký tự nào. Nếu được đặt, thuộc tính này sẽ được sử dụng thay vì "giá ưu đãi", ví dụ: Đang giảm giá 80.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ì trường iosAppLink cũng phải xuất hiện.
similarDestinationIds[]

string

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

string

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

DiscoveryCarouselCardAsset

Thành phần Thẻ băng chuyền 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ị có tỷ lệ 1,91:1 được liên kết. Bạn phải thêm thành phần hình ảnh tiếp thị hình vuông và/hoặc thành phần hình ảnh tiếp thị này.
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 hình ảnh tiếp thị này và/hoặc.
portraitMarketingImageAsset

string

Tên tài nguyên thành phần của hình ảnh tiếp thị dọc 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

Văn bản lời kêu gọi hành động.

DynamicTravelAsset

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 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ẻ tái tiếp thị. 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ã nhận dạng (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 đích đến, ví dụ: Paris.
destinationAddress

string

Địa chỉ điểm đến 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.
originName

string

Tên điểm xuất phát, ví dụ: London.
price

string

Giá có thể là một con số đứng trước 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ụ: 1000000.00 VND.
salePrice

string

Giá ưu đãi có thể là một chữ 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ụ: 800000.00 VND. 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 được đặt, thuộc tính này sẽ được sử dụng thay cho "price", ví dụ: Giá từ 100 USD.
formattedSalePrice

string

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

string

Danh mục, ví dụ: Express.
contextualKeywords[]

string

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

string

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

string

URL 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ì trường iosAppLink cũng phải xuất hiện.

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à 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 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 Mountain View Serves. 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 hóa đơ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ụ: 1000000.00 VND.
salePrice

string

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

string

URL 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ụ: Đồ ăn.
contextualKeywords[]

string

Từ khoá theo ngữ cảnh, ví dụ: Tiết kiệm 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 được đặt, thuộc tính này sẽ được sử dụng thay cho "price", ví dụ: Giá từ 100 USD.
formattedSalePrice

string

Giá ưu đãi được định dạng, có thể là bất kỳ ký tự nào. Nếu được đặt, thuộc tính này sẽ được sử dụng thay vì "giá ưu đãi", ví dụ: Đang giảm giá 80.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ì trường iosAppLink cũng phải có.

DynamicJobsAsset

Thành phần linh động về công việc.

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à 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 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à chữ số bất kỳ. Chuỗi mã nhận dạng (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

Phụ đề của công việc, ví dụ: Cấp II.
description

string

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

string

URL 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

Tiền lương, ví dụ: 100.000 đô la Mỹ.
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ì trường iosAppLink cũng phải xuất hiện.

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 giúp xác định riêng một địa điểm trong cơ sở dữ liệu Google Địa điểm và trên Google Maps. Đây là trường dành riêng cho một mã khách hàng và loại thành phần nhất định. Hãy xem https://developers.google.com/places/web-service/place-id để tìm hiểu thêm về ID địa điểm.
businessProfileLocations[]

object (BusinessProfileLocation)

Danh sách các địa điểm doanh nghiệp của khách hàng. Thông tin này chỉ được trả về nếu Thành phần địa điểm đang đồng bộ hoá từ tài khoản Trang doanh nghiệp. Một tài khoản có thể có nhiều trang thông tin trên Trang doanh nghiệp 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 là BUSINESS_OWNER, 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à LIÊN KẾT, thì vị trí đó sẽ được phân phát dưới dạng vị trí đơn vị liên kết.

BusinessProfileLocation

Dữ liệu vị trí trên Trang doanh nghiệp được đồng bộ hoá từ tài khoản Trang doanh nghiệp được 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 của 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 được 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 giúp xác định riêng một địa điểm trong cơ sở dữ liệu Google Địa điểm và trên Google Maps. Hãy xem 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ó thể đọc.
hotelName

string

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