REST Resource: customers.ads

FinalAppUrl

URL để liên kết sâu đến một ứng dụng của hệ điều hành cụ thể.

Biểu diễn dưới dạng JSON 
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
Trường
osType

enum (AppUrlOperatingSystemType)

Hệ điều hành mà URL này nhắm mục tiêu. Bắt buộc.
url

string

URL liên kết sâu của ứng dụng. Đường liên kết sâu chỉ định một vị trí trong ứng dụng tương ứng với nội dung mà bạn muốn hiển thị và phải có dạng {lược đồ}://{host_path} Lược đồ xác định ứng dụng cần mở. Đối với ứng dụng của mình, bạn có thể sử dụng một lược đồ tuỳ chỉnh bắt đầu bằng tên ứng dụng. Máy chủ lưu trữ và đường dẫn chỉ định vị trí duy nhất trong ứng dụng nơi nội dung của bạn tồn tại. Ví dụ: "exampleapp://productid_1234". Bắt buộc.

AppUrlOperatingSystemType

Hệ điều hành

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.
IOS Hệ điều hành iOS của Apple.
ANDROID Hệ điều hành Android.

CustomParameter

Mối liên kết mà thẻ thông số tuỳ chỉnh có thể sử dụng trong trackingUrlTemplate, finalUrls hoặc mobile_final_urls.

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

string

Khoá khớp với tên thẻ thông số.
value

string

Giá trị cần thay thế.

AdType

Các loại quảng cáo có thể xảy ra.

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đây là giá trị chỉ phản hồi.
TEXT_AD Quảng cáo là quảng cáo dạng văn bản.
EXPANDED_TEXT_AD Quảng cáo là quảng cáo văn bản mở rộng.
EXPANDED_DYNAMIC_SEARCH_AD Quảng cáo này là quảng cáo tìm kiếm động mở rộng.
HOTEL_AD Quảng cáo này là quảng cáo khách sạn.
SHOPPING_SMART_AD Quảng cáo này là Quảng cáo mua sắm thông minh.
SHOPPING_PRODUCT_AD Quảng cáo này là quảng cáo Mua sắm thông thường.
VIDEO_AD Quảng cáo này là quảng cáo dạng video.
IMAGE_AD Quảng cáo này là Quảng cáo hình ảnh.
RESPONSIVE_SEARCH_AD Quảng cáo này là quảng cáo tìm kiếm thích ứng.
LEGACY_RESPONSIVE_DISPLAY_AD Quảng cáo này là quảng cáo hiển thị thích ứng cũ.
APP_AD Quảng cáo là quảng cáo ứng dụng.
LEGACY_APP_INSTALL_AD Quảng cáo là quảng cáo cài đặt ứng dụng cũ.
RESPONSIVE_DISPLAY_AD Quảng cáo này là quảng cáo hiển thị thích ứng.
LOCAL_AD Quảng cáo này là quảng cáo địa phương.
HTML5_UPLOAD_AD Quảng cáo là quảng cáo tải lên hiển thị có loại sản phẩm HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD Quảng cáo là quảng cáo hiển thị hình ảnh tải lên với một trong các loại sản phẩm dynamic_HTML5_*.
APP_ENGAGEMENT_AD Quảng cáo là quảng cáo tương tác với ứng dụng.
SHOPPING_COMPARISON_LISTING_AD Quảng cáo là quảng cáo so sánh sản phẩm mua sắm.
VIDEO_BUMPER_AD Quảng cáo đệm video.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Quảng cáo trong luồng phát không thể bỏ qua dạng video.
VIDEO_OUTSTREAM_AD Quảng cáo video ngoài luồng phát.
VIDEO_TRUEVIEW_IN_STREAM_AD Quảng cáo TrueView trong luồng dạng video.
VIDEO_RESPONSIVE_AD Quảng cáo thích ứng dạng video.
SMART_CAMPAIGN_AD Quảng cáo chiến dịch thông minh.
CALL_AD Quảng cáo tạo cuộc gọi.
APP_PRE_REGISTRATION_AD Quảng cáo đăng ký trước ứng dụng toàn cầu.
IN_FEED_VIDEO_AD Quảng cáo dạng video trong nguồn cấp dữ liệu.
DISCOVERY_MULTI_ASSET_AD Quảng cáo khám phá nhiều thành phần.
TRAVEL_AD Quảng cáo du lịch.
DISCOVERY_VIDEO_RESPONSIVE_AD Quảng cáo khám phá dạng video thích ứng.

Thiết bị

Liệt kê các thiết bị Google Ads có sẵn để nhắm mục tiêu.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Giá trị không xác định trong phiên bản này.
MOBILE Thiết bị di động có trình duyệt hoàn chỉnh.
TABLET Máy tính bảng có trình duyệt hoàn chỉnh.
DESKTOP Máy tính.
CONNECTED_TV TV thông minh và máy chơi trò chơi.
OTHER Các loại thiết bị khác.

UrlCollection

Tập hợp các URL được gắn thẻ bằng một giá trị nhận dạng duy nhất.

Biểu diễn dưới dạng JSON 
{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}
Trường
finalUrls[]

string

Danh sách các URL cuối cùng có thể có.
finalMobileUrls[]

string

Danh sách các URL cuối cùng trên thiết bị di động có thể có.
urlCollectionId

string

Giá trị nhận dạng duy nhất cho thực thể UrlCollection này.
trackingUrlTemplate

string

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

SystemManagedResourceSource

Enum liệt kê các nguồn thực thể có thể do hệ thống quản lý.

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.
AD_VARIATIONS Quảng cáo thử nghiệm biến thể quảng cáo đã tạo.

TextAdInfo

Quảng cáo dạng văn bản.

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

string

Dòng tiêu đề của quảng cáo.
description1

string

Dòng đầu tiên trong phần mô tả của quảng cáo.
description2

string

Dòng thứ hai trong nội dung mô tả của quảng cáo.

ExpandedTextAdInfo

Quảng cáo dạng văn bản mở rộng.

Biểu diễn dưới dạng JSON 
{
  "headlinePart1": string,
  "headlinePart2": string,
  "headlinePart3": string,
  "description": string,
  "description2": string,
  "path1": string,
  "path2": string
}
Trường
headlinePart1

string

Phần đầu tiên của dòng tiêu đề của quảng cáo.
headlinePart2

string

Phần thứ hai của dòng tiêu đề của quảng cáo.
headlinePart3

string

Phần thứ ba của dòng tiêu đề quảng cáo.
description

string

Nội dung mô tả về quảng cáo.
description2

string

Dòng mô tả thứ hai của quảng cáo.
path1

string

Văn bản có thể xuất hiện cùng với URL hiển thị của quảng cáo.
path2

string

Văn bản bổ sung có thể xuất hiện cùng với URL hiển thị của quảng cáo.

CallAdInfo

Quảng cáo tạo cuộc gọi.

Biểu diễn dưới dạng JSON 
{
  "countryCode": string,
  "phoneNumber": string,
  "businessName": string,
  "headline1": string,
  "headline2": string,
  "description1": string,
  "description2": string,
  "callTracked": boolean,
  "disableCallConversion": boolean,
  "phoneNumberVerificationUrl": string,
  "conversionAction": string,
  "conversionReportingState": enum (CallConversionReportingState),
  "path1": string,
  "path2": string
}
Trường
countryCode

string

Mã quốc gia trong quảng cáo.
phoneNumber

string

Số điện thoại trong quảng cáo.
businessName

string

Tên doanh nghiệp trong quảng cáo.
headline1

string

Dòng tiêu đề đầu tiên trong quảng cáo.
headline2

string

Dòng tiêu đề thứ hai trong quảng cáo.
description1

string

Dòng đầu tiên trong phần mô tả của quảng cáo.
description2

string

Dòng thứ hai trong nội dung mô tả của quảng cáo.
callTracked

boolean

Liệu có bật tính năng theo dõi cuộc gọi cho mẫu quảng cáo hay không. Việc bật tính năng theo dõi cuộc gọi cũng cho phép chuyển đổi cuộc gọi.
disableCallConversion

boolean

Liệu có tắt chuyển đổi cuộc gọi cho quảng cáo hay không. Nếu bạn đặt thành true, hãy tắt lượt chuyển đổi cuộc gọi ngay cả khi callTracked là true. Nếu callTracked là false, trường này sẽ bị bỏ qua.
phoneNumberVerificationUrl

string

URL được sử dụng để xác minh số điện thoại.
conversionAction

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 một hành động chuyển đổi mặc định. Trường này chỉ có hiệu lực nếu bạn đặt callTracked thành true. Nếu không, trường này sẽ bị bỏ qua.
conversionReportingState

enum (CallConversionReportingState)

Hành vi chuyển đổi cuộc gọi của quảng cáo tạo cuộc gọi này. Loại chiến dịch này có thể sử dụng chế độ cài đặt lượt chuyển đổi cuộc gọi của riêng mình, kế thừa chế độ cài đặt cấp tài khoản hoặc bị vô hiệu hoá.
path1

string

Phần đầu tiên của văn bản có thể được thêm vào URL trong quảng cáo. Không bắt buộc.
path2

string

Phần thứ hai của văn bản có thể được nối thêm vào URL trong quảng cáo. Bạn chỉ có thể đặt trường này khi cũng đặt path1. Không bắt buộc.

CallConversionReportingState

Các loại dữ liệu có thể có cho trạng thái hành động chuyển đổi liên quan đến cuộc gọi.

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.
DISABLED Hành động chuyển đổi cuộc gọi đã bị vô hiệu hóa.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION Hành động chuyển đổi cuộc gọi sẽ sử dụng loại chuyển đổi cuộc gọi được đặt ở cấp tài khoản.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION Hành động chuyển đổi cuộc gọi sẽ sử dụng loại chuyển đổi cuộc gọi được đặt ở cấp tài nguyên (quảng cáo chỉ tạo cuộc gọi điện thoại/phần mở rộng về cuộc gọi).

ExpandedDynamicSearchAdInfo

Quảng cáo tìm kiếm động mở rộng.

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

string

Nội dung mô tả về quảng cáo.
description2

string

Dòng mô tả thứ hai của quảng cáo.

HotelAdInfo

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

Quảng cáo khách sạn.

ShoppingSmartAdInfo

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

Quảng cáo mua sắm thông minh.

ShoppingProductAdInfo

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

Quảng cáo mua sắm thông thường.

ImageAdInfo

Quảng cáo dạng hình ảnh.

Biểu diễn dưới dạng JSON 
{
  "mimeType": enum (MimeType),
  "pixelWidth": string,
  "pixelHeight": string,
  "imageUrl": string,
  "previewPixelWidth": string,
  "previewPixelHeight": string,
  "previewImageUrl": string,
  "name": string,

  // Union field image can be only one of the following:
  "mediaFile": string,
  "data": string,
  "adIdToCopyImageFrom": string
  // End of list of possible types for union field image.
}
Trường
mimeType

enum (MimeType)

Loại MIME của hình ảnh.
pixelWidth

string (int64 format)

Chiều rộng tính bằng pixel của hình ảnh có kích thước đầy đủ.
pixelHeight

string (int64 format)

Chiều cao tính bằng pixel của hình ảnh có kích thước đầy đủ.
imageUrl

string

URL của hình ảnh có kích thước đầy đủ.
previewPixelWidth

string (int64 format)

Chiều rộng tính bằng pixel của hình ảnh kích thước xem trước.
previewPixelHeight

string (int64 format)

Chiều cao tính bằng pixel của hình ảnh kích thước xem trước.
previewImageUrl

string

URL của hình ảnh có kích thước xem trước.
name

string

Tên của hình ảnh. Nếu hình ảnh được tạo từ một tệp thuế được tạo, thì đây sẽ là tên của tệp đó. Nếu hình ảnh được tạo từ byte thì trường này trống.
Trường hợp image. Hình ảnh để tạo ImageAd. Bạn có thể chỉ định URL này theo một trong hai cách. 1. Tài nguyên ImageView hiện có. 2. Dữ liệu hình ảnh thô dưới dạng byte. image chỉ có thể là một trong những trạng thái sau:
mediaFile

string

Tài nguyên EDSA để sử dụng cho hình ảnh.
data

string (bytes format)

Dữ liệu hình ảnh thô dưới dạng byte.

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

string (int64 format)

Mã quảng cáo để sao chép hình ảnh.

MimeType

Loại MIME

Enum
UNSPECIFIED Loại MIME chưa được chỉ định.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đây là giá trị chỉ phản hồi.
IMAGE_JPEG Loại MIME của hình ảnh/jpeg.
IMAGE_GIF Loại MIME của hình ảnh/gif.
IMAGE_PNG Loại MIME của hình ảnh/png.
FLASH Loại MIME của ứng dụng/x-shockwave-flash.
TEXT_HTML Loại văn bản/html MIME.
PDF Loại MIME của ứng dụng/pdf.
MSWORD Loại MIME của ứng dụng/msword.
MSEXCEL Loại MIME của ứng dụng/vnd.ms-excel.
RTF Loại MIME của ứng dụng/rtf.
AUDIO_WAV Loại MIME của âm thanh/wav.
AUDIO_MP3 Loại MIME của âm thanh/mp3.
HTML5_AD_ZIP Loại MIME của application/x-html5-ad-zip.

VideoAdInfo

Quảng cáo dạng video.

Biểu diễn dưới dạng JSON 
{
  "video": {
    object (AdVideoAsset)
  },

  // Union field format can be only one of the following:
  "inStream": {
    object (VideoTrueViewInStreamAdInfo)
  },
  "bumper": {
    object (VideoBumperInStreamAdInfo)
  },
  "outStream": {
    object (VideoOutstreamAdInfo)
  },
  "nonSkippable": {
    object (VideoNonSkippableInStreamAdInfo)
  },
  "inFeed": {
    object (InFeedVideoAdInfo)
  }
  // End of list of possible types for union field format.
}
Trường
video

object (AdVideoAsset)

Nội dung video trên YouTube được dùng cho quảng cáo.
Trường hợp format. Giản đồ theo định dạng cụ thể cho các định dạng video khác nhau. format chỉ có thể là một trong những trạng thái sau:
inStream

object (VideoTrueViewInStreamAdInfo)

Định dạng quảng cáo TrueView trong luồng dạng video.
bumper

object (VideoBumperInStreamAdInfo)

Định dạng quảng cáo trong luồng đệm video.
outStream

object (VideoOutstreamAdInfo)

Định dạng quảng cáo video ngoài luồng.
nonSkippable

object (VideoNonSkippableInStreamAdInfo)

Định dạng quảng cáo trong luồng phát không thể bỏ qua dạng video.
inFeed

object (InFeedVideoAdInfo)

Định dạng quảng cáo dạng video trong nguồn cấp dữ liệu.

AdVideoAsset

Thành phần video được dùng trong một quảng cáo.

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

string

Tên tài nguyên Tài sản của video này.

VideoTrueViewInStreamAdInfo

Phần hiển thị định dạng quảng cáo TrueView trong luồng video (quảng cáo hiển thị trong khi phát lại video, thường là ở đầu video, hiển thị nút bỏ qua vài giây trong video).

Biểu diễn dưới dạng JSON 
{
  "actionButtonLabel": string,
  "actionHeadline": string,
  "companionBanner": {
    object (AdImageAsset)
  }
}
Trường
actionButtonLabel

string

Nhãn trên nút CTA (lời kêu gọi hành động) đưa người dùng đến URL cuối cùng của quảng cáo video. Bắt buộc đối với chiến dịch TrueView cho hành động, không bắt buộc.
actionHeadline

string

Văn bản bổ sung được hiển thị cùng với nút CTA (lời kêu gọi hành động) để cung cấp ngữ cảnh và khuyến khích nhấp vào nút.
companionBanner

object (AdImageAsset)

Thành phần hình ảnh của biểu ngữ đi kèm được dùng với quảng cáo.

AdImageAsset

Thành phần hình ảnh được sử dụng trong một quảng cáo.

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

string

Tên tài nguyên Tài sản của hình ảnh này.

VideoBumperInStreamAdInfo

Phần hiển thị định dạng quảng cáo trong luồng đệm video (quảng cáo dạng video không thể bỏ qua trong luồng rất ngắn).

Biểu diễn dưới dạng JSON 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
Trường
companionBanner

object (AdImageAsset)

Thành phần hình ảnh của biểu ngữ đi kèm được dùng với quảng cáo.
actionButtonLabel

string

Nhãn trên nút "Gọi hành động" đưa người dùng đến URL cuối cùng của quảng cáo video.
actionHeadline

string

Văn bản bổ sung được hiển thị cùng với nút CTA (lời kêu gọi hành động) để cung cấp ngữ cảnh và khuyến khích nhấp vào nút.

VideoOutstreamAdInfo

Hình ảnh minh hoạ định dạng quảng cáo dạng video ngoài luồng (quảng cáo xuất hiện cùng với một nguồn cấp dữ liệu có tính năng tự động phát, không có âm thanh).

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

string

Dòng tiêu đề của quảng cáo.
description

string

Dòng mô tả.

VideoNonSkippableInStreamAdInfo

Hình ảnh minh hoạ định dạng quảng cáo trong luồng phát không thể bỏ qua dạng video (quảng cáo dạng video không thể bỏ qua dài 15 giây).

Biểu diễn dưới dạng JSON 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
Trường
companionBanner

object (AdImageAsset)

Thành phần hình ảnh của biểu ngữ đi kèm được dùng với quảng cáo.
actionButtonLabel

string

Nhãn trên nút "Gọi hành động" đưa người dùng đến URL cuối cùng của quảng cáo video.
actionHeadline

string

Văn bản bổ sung được hiển thị cùng với nút "Lời kêu gọi hành động" để cung cấp ngữ cảnh và khuyến khích người dùng nhấp vào nút.

InFeedVideoAdInfo

Hình ảnh minh hoạ định dạng quảng cáo dạng video trong nguồn cấp dữ liệu.

Biểu diễn dưới dạng JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "thumbnail": enum (VideoThumbnail)
}
Trường
headline

string

Dòng tiêu đề của quảng cáo.
description1

string

Dòng văn bản đầu tiên của quảng cáo.
description2

string

Dòng văn bản thứ hai cho quảng cáo.
thumbnail

enum (VideoThumbnail)

Hình ảnh thu nhỏ của video để sử dụng.

VideoThumbnail

Enum liệt kê các loại hình thu nhỏ video có thể có.

Enum
UNSPECIFIED Loại chưa được chỉ định.
UNKNOWN Phiên bản này không xác định giá trị đã nhận. Đây là giá trị chỉ phản hồi.
DEFAULT_THUMBNAIL Hình thu nhỏ mặc định. Có thể được tạo tự động hoặc do người dùng tải lên.
THUMBNAIL_1 Hình thu nhỏ 1, được tạo từ video.
THUMBNAIL_2 Hình thu nhỏ 2, được tạo từ video.
THUMBNAIL_3 Hình thu nhỏ 3, được tạo từ video.

VideoResponsiveAdInfo

Quảng cáo thích ứng dạng video.

Biểu diễn dưới dạng JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "companionBanners": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string
}
Trường
headlines[]

object (AdTextAsset)

Danh sách thành phần văn bản được dùng cho dòng tiêu đề ngắn. Hiện tại, chúng tôi chỉ hỗ trợ một giá trị duy nhất cho dòng tiêu đề ngắn.
longHeadlines[]

object (AdTextAsset)

Danh sách thành phần văn bản được dùng cho dòng tiêu đề dài. Hiện tại, chúng tôi chỉ hỗ trợ một giá trị duy nhất cho dòng tiêu đề dài.
descriptions[]

object (AdTextAsset)

Danh sách thành phần văn bản được dùng cho nội dung mô tả. Hiện tại, chúng tôi chỉ hỗ trợ một giá trị duy nhất cho nội dung mô tả.
callToActions[]

object (AdTextAsset)

Danh sách thành phần văn bản được sử dụng cho nút, chẳng hạn như nút "Gọi hành động". Hiện tại, chúng tôi chỉ hỗ trợ một giá trị duy nhất cho nút này.
videos[]

object (AdVideoAsset)

Danh sách tài sản video trên YouTube được dùng cho quảng cáo. Hiện tại, chúng tôi chỉ hỗ trợ một giá trị duy nhất cho nội dung video trên YouTube.
companionBanners[]

object (AdImageAsset)

Danh sách thành phần hình ảnh dùng cho biểu ngữ đi kèm. Hiện tại, chúng tôi chỉ hỗ trợ một giá trị duy nhất cho thành phần biểu ngữ đi kèm.
breadcrumb1

string

Phần đầu tiên của văn bản xuất hiện trong quảng cáo cùng với URL hiển thị.
breadcrumb2

string

Phần thứ hai của văn bản xuất hiện trong quảng cáo cùng với URL hiển thị.

AdTextAsset

Thành phần văn bản được sử dụng trong quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "pinnedField": enum (ServedAssetFieldType),
  "assetPerformanceLabel": enum (AssetPerformanceLabel),
  "policySummaryInfo": {
    object (AdAssetPolicySummary)
  },
  "text": string
}
Trường
pinnedField

enum (ServedAssetFieldType)

Trường đã ghim của tài sản. Điều này khiến thành phần chỉ phân phát trong trường này. Bạn có thể ghim nhiều thành phần vào cùng một trường. Một nội dung đã được bỏ ghim hoặc ghim vào một trường khác sẽ không phân phát trong trường mà một số nội dung khác đã được ghim.
assetPerformanceLabel

enum (AssetPerformanceLabel)

Nhãn hiệu suất của thành phần văn bản này.
policySummaryInfo

object (AdAssetPolicySummary)

Thông tin tóm tắt về chính sách của thành phần văn bản này.
text

string

Văn bản nội dung.

ServedAssetFieldType

Các loại trường tài sản có thể có.

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đây là giá trị chỉ phản hồi.
HEADLINE_1 Thành phần này được sử dụng trong dòng tiêu đề 1.
HEADLINE_2 Thành phần này được sử dụng trong dòng tiêu đề 2.
HEADLINE_3 Thành phần này được sử dụng trong dòng tiêu đề 3.
DESCRIPTION_1 Thành phần này được sử dụng trong dòng mô tả 1.
DESCRIPTION_2 Thành phần này được sử dụng trong dòng mô tả 2.
CALL Thành phần này được dùng làm một cuộc gọi.
MOBILE_APP Thành phần này được dùng làm ứng dụng di động.
CALLOUT Thành phần này được dùng làm chú thích.
STRUCTURED_SNIPPET Thành phần này được dùng làm đoạn thông tin có cấu trúc.
PRICE Thành phần này được dùng làm giá.
PROMOTION Thành phần này được dùng làm chương trình khuyến mãi.
AD_IMAGE Thành phần này được dùng làm hình ảnh.
LEAD_FORM Thành phần này được dùng làm biểu mẫu khách hàng tiềm năng.

AssetPerformanceLabel

Enum mô tả các nhãn hiệu suất có thể có của một tài sản, thường được tính toán khi có mối liên kết.

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.
PENDING Nội dung này chưa có bất kỳ thông tin nào về hiệu suất. Nguyên nhân có thể là vì sản phẩm vẫn đang được xem xét.
LEARNING Thành phần này đã bắt đầu nhận được lượt hiển thị nhưng số liệu thống kê không đủ ý nghĩa thống kê để được gắn nhãn hiệu suất của thành phần.
LOW Những thành phần hoạt động kém hiệu quả nhất.
GOOD Các thành phần hoạt động hiệu quả.
BEST Những thành phần hoạt động hiệu quả nhất.

AdAssetPolicySummary

Chứa thông tin chính sách của một thành phần bên trong một quảng cáo.

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

object (PolicyTopicEntry)

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)

Vị trí trong quá trình xem xét thành phần này.
approvalStatus

enum (PolicyApprovalStatus)

Trạng thái phê duyệt chung 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ẻ.

PolicyTopicEntry

Phát hiện chính sách được đính kèm với một tài nguyên (ví dụ: chính sách về đồ uống có cồn có liên kết với một trang web bán đồ uống có cồn).

Mỗi PolicyTopicsEntry có một chủ đề cho biết chính sách quảng cáo cụ thể mà mục nhập đề cập đến và một loại cho biết tác động của mục nhập đó đối với việc phân phát. Bản sao này có thể có một hoặc nhiều bằng chứng (không bắt buộc) cho biết lý do tìm kiếm. Ngoài ra, nhóm này cũng có thể có một hoặc nhiều quy tắc ràng buộc nhằm cung cấp thông tin chi tiết về việc hạn chế phân phát như thế nào.

Biểu diễn dưới dạng JSON 
{
  "type": enum (PolicyTopicEntryType),
  "evidences": [
    {
      object (PolicyTopicEvidence)
    }
  ],
  "constraints": [
    {
      object (PolicyTopicConstraint)
    }
  ],
  "topic": string
}
Trường
type

enum (PolicyTopicEntryType)

Mô tả tác động tiêu cực hoặc tích cực của chính sách này đối với việc phân phát.
evidences[]

object (PolicyTopicEvidence)

Thông tin bổ sung giải thích về kết quả xác định chính sách (ví dụ: tên thương hiệu cho kết quả tìm kiếm nhãn hiệu).
constraints[]

object (PolicyTopicConstraint)

Cho biết mức độ ảnh hưởng đến việc phân phát tài nguyên này (ví dụ: không phân phát ở một quốc gia).
topic

string

Chủ đề chính sách mà phát hiện này đề cập đến. Ví dụ: "ALCOHOL", "TRADEMARKS_IN_AD_TEXT" hoặc "optout_NOT_WORKING". Một nhóm các chủ đề có thể có về chính sách không được cố định cho một phiên bản API cụ thể và có thể thay đổi bất cứ lúc nào.

PolicyTopicEntryType

Các loại mục nhập chủ đề chính sách có thể có.

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đây là giá trị chỉ phản hồi.
PROHIBITED Tài nguyên sẽ không được phân phát.
LIMITED Tài nguyên sẽ không được phân phối trong một số trường hợp.
FULLY_LIMITED Tài nguyên không thể phân phát do tiêu chí nhắm mục tiêu hiện tại.
DESCRIPTIVE Bạn có thể quan tâm, nhưng không giới hạn cách phân phát tài nguyên.
BROADENING Có thể tăng mức độ phù hợp vượt quá mức bình thường.
AREA_OF_INTEREST_ONLY Giới hạn đối với tất cả các quốc gia được nhắm đến, nhưng có thể phân phát ở các quốc gia khác thông qua khu vực mà họ quan tâm.

PolicyTopicEvidence

Thông tin bổ sung giải thích về phát hiện của chính sách.

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

  // Union field value can be only one of the following:
  "websiteList": {
    object (WebsiteList)
  },
  "textList": {
    object (TextList)
  },
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  }
  // End of list of possible types for union field value.
}
Trường
Trường hợp value. Thông tin cụ thể bằng chứng tuỳ thuộc vào loại bằng chứng. value chỉ có thể là một trong những trạng thái sau:
websiteList

object (WebsiteList)

Danh sách các trang web được liên kết với tài nguyên này.
textList

object (TextList)

Danh sách bằng chứng tìm thấy trong nội dung tài liệu.
languageCode

string

Ngôn ngữ mà tài nguyên được phát hiện để viết. Đây là thẻ ngôn ngữ IETF, chẳng hạn như "en-US".
destinationTextList

object (DestinationTextList)

Văn bản trong đích đến của tài nguyên gây ra quá trình tìm ra chính sách.
destinationMismatch

object (DestinationMismatch)

Các đích đến của URL tài nguyên không khớp.
destinationNotWorking

object (DestinationNotWorking)

Thông tin chi tiết khi đích đến đang trả về mã lỗi HTTP hoặc không hoạt động ở một số vị trí đối với các thiết bị thường dùng.

WebsiteList

Danh sách các trang web giúp phát hiện ra chính sách. Ví dụ: được sử dụng cho chủ đề chính sách ONE_WEBSITE_PER_AD_GROUP. Trong trường hợp có nhiều hơn 5 trang web, thì chỉ 5 trang web hàng đầu (những trang web xuất hiện nhiều nhất trong các tài nguyên) sẽ được liệt kê ở đây.

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

string

Các trang web dẫn đến việc phát hiện chính sách.

TextList

Danh sách các đoạn văn bản vi phạm chính sách.

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

string

Các đoạn văn bản trong tài nguyên dẫn đến việc phát hiện chính sách.

DestinationTextList

Danh sách các chuỗi được tìm thấy trong trang đích dẫn đến việc tìm kiếm chính sách.

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

string

Danh sách văn bản tìm thấy trên trang đích của tài nguyên.

DestinationMismatch

Bằng chứng về việc không khớp giữa các URL của một tài nguyên.

Biểu diễn dưới dạng JSON 
{
  "urlTypes": [
    enum (PolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
Trường
urlTypes[]

enum (PolicyTopicEvidenceDestinationMismatchUrlType)

Tập hợp các URL không khớp với nhau.

PolicyTopicEvidenceDestinationMismatchUrlType

Các loại URL đích không khớp trên trang đích của bằng chứng về chính sách có thể có.

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đây là giá trị chỉ phản hồi.
DISPLAY_URL URL hiển thị.
FINAL_URL URL cuối cùng.
FINAL_MOBILE_URL URL cuối cùng dành cho thiết bị di động.
TRACKING_URL Mẫu URL theo dõi, có URL dành cho máy tính được thay thế.
MOBILE_TRACKING_URL Mẫu URL theo dõi, có URL dành cho thiết bị di động thay thế.

DestinationNotWorking

Thông tin chi tiết về bằng chứng khi đích đến đang trả về mã lỗi HTTP hoặc không hoạt động ở một số vị trí đối với các thiết bị thường dùng.

Biểu diễn dưới dạng JSON 
{
  "device": enum (PolicyTopicEvidenceDestinationNotWorkingDevice),
  "expandedUrl": string,
  "lastCheckedDateTime": string,

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}
Trường
device

enum (PolicyTopicEvidenceDestinationNotWorkingDevice)

Loại thiết bị không tải được URL này.
expandedUrl

string

URL đầy đủ không hoạt động.
lastCheckedDateTime

string

Thời gian URL được kiểm tra lần gần đây nhất. Định dạng là "YYYY-MM-DD HH:MM:SS". Ví dụ: "2018-03-05 09:15:00" hoặc "2018-02-01 14:34:30"
Trường hợp reason. Cho biết lý do của việc tìm thấy chính sách {/6}_NOT_WORKING. reason chỉ có thể là một trong những trạng thái sau:
dnsErrorType

enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

Loại lỗi DNS.
httpErrorCode

string (int64 format)

Mã lỗi HTTP.

PolicyTopicEvidenceDestinationNotWorkingDevice

Đích đến bằng chứng chủ đề chính sách có thể có không hoạt động.

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đây là giá trị chỉ phản hồi.
DESKTOP Trang đích không hoạt động trên thiết bị máy tính.
ANDROID Trang đích không hoạt động trên thiết bị Android.
IOS Trang đích không hoạt động trên thiết bị iOS.

PolicyTopicEvidenceDestinationNotWorkingDnsErrorType

Đích đến bằng chứng về chủ đề chính sách có thể không hoạt động với các loại lỗi DNS.

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đây là giá trị chỉ phản hồi.
HOSTNAME_NOT_FOUND Không tìm thấy tên máy chủ trong DNS khi tìm nạp trang đích.
GOOGLE_CRAWLER_DNS_ISSUE Sự cố trình thu thập thông tin nội bộ của Google khi giao tiếp với DNS. Lỗi này không có nghĩa là trang đích không hoạt động. Google sẽ thu thập lại dữ liệu trên trang đích.

PolicyTopicConstraint

Mô tả tác động đến việc phân phát mục nhập chủ đề chính sách.

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

  // Union field value can be only one of the following:
  "countryConstraintList": {
    object (CountryConstraintList)
  },
  "resellerConstraint": {
    object (ResellerConstraint)
  },
  "certificateMissingInCountryList": {
    object (CountryConstraintList)
  },
  "certificateDomainMismatchInCountryList": {
    object (CountryConstraintList)
  }
  // End of list of possible types for union field value.
}
Trường
Trường hợp value. Thông tin cụ thể về quy tắc ràng buộc. value chỉ có thể là một trong những trạng thái sau:
countryConstraintList

object (CountryConstraintList)

Các quốc gia nơi tài nguyên không thể phân phát.
resellerConstraint

object (ResellerConstraint)

Quy tắc ràng buộc về đại lý.
certificateMissingInCountryList

object (CountryConstraintList)

Các quốc gia yêu cầu phải có chứng chỉ để phân phát quảng cáo.
certificateDomainMismatchInCountryList

object (CountryConstraintList)

Các quốc gia nơi miền của tài nguyên không thuộc phạm vi điều chỉnh của các chứng chỉ liên kết với tài nguyên đó.

CountryConstraintList

Danh sách các quốc gia bị hạn chế phân phát tài nguyên.

Biểu diễn dưới dạng JSON 
{
  "countries": [
    {
      object (CountryConstraint)
    }
  ],
  "totalTargetedCountries": integer
}
Trường
countries[]

object (CountryConstraint)

Các quốc gia bị hạn chế phân phát quảng cáo.
totalTargetedCountries

integer

Tổng số quốc gia mà tài nguyên nhắm đến.

CountryConstraint

Cho biết rằng khả năng phân phát của tài nguyên ở một quốc gia cụ thể bị hạn chế.

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

string

Tên tài nguyên không đổi cho mục tiêu theo vị trí địa lý của quốc gia mà việc phân phát quảng cáo bị hạn chế.

ResellerConstraint

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

Cho biết rằng chủ đề chính sách đã bị hạn chế do trang web không phục vụ mục đích của đại lý.

PolicyReviewStatus

Các trạng thái đánh giá việc tuân thủ chính sách có thể có.

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đây là giá trị chỉ phản hồi.
REVIEW_IN_PROGRESS Hiện đang được xem xét.
REVIEWED Đã hoàn tất quá trình xem xét chính. Các quy trình xem xét khác có thể vẫn đang tiếp tục.
UNDER_APPEAL Tài nguyên này đã được gửi lại để phê duyệt hoặc bạn đã khiếu nại quyết định về chính sách của tài nguyên đó.
ELIGIBLE_MAY_SERVE Tài nguyên đủ điều kiện và có thể đang được phân phát nhưng vẫn có thể bị xem xét thêm.

PolicyApprovalStatus

Các trạng thái phê duyệt chính sách có thể có. Khi có nhiều trạng thái phê duyệt, trạng thái nghiêm trọng nhất sẽ được sử dụng. Thứ tự mức độ nghiêm trọng là example, AREA_OF_INTEREST_ONLY, APPROVED_LIMITED và APPROVED.

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đây là giá trị chỉ phản hồi.
DISAPPROVED Sẽ không phân phát.
APPROVED_LIMITED Phân phát có quy định hạn chế.
APPROVED Phân phát mà không có hạn chế.
AREA_OF_INTEREST_ONLY Sẽ không phân phát ở các quốc gia được nhắm đến, nhưng có thể phân phát cho những người dùng đang tìm kiếm thông tin về các quốc gia được nhắm đến.

ResponsiveSearchAdInfo

Quảng cáo tìm kiếm thích ứng.

Quảng cáo tìm kiếm thích ứng giúp bạn tạo những quảng cáo có thể tự điều chỉnh để hiển thị nhiều văn bản hơn và các thông điệp phù hợp hơn cho khách hàng. Hãy nhập nhiều dòng tiêu đề và nội dung mô tả khi tạo quảng cáo tìm kiếm thích ứng. Theo thời gian, Google Ads sẽ tự động kiểm tra các kiểu kết hợp khác nhau và tìm ra những kiểu kết hợp hoạt động hiệu quả nhất. Bằng cách điều chỉnh nội dung quảng cáo cho phù hợp hơn với các cụm từ tìm kiếm của khách hàng tiềm năng, quảng cáo tìm kiếm thích ứng có thể cải thiện hiệu suất chiến dịch của bạn.

Tìm hiểu thêm thông tin tại https://support.google.com/google-ads/answer/7684791

Biểu diễn dưới dạng JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string
}
Trường
headlines[]

object (AdTextAsset)

Danh sách thành phần văn bản cho dòng tiêu đề. Khi quảng cáo phân phát, các dòng tiêu đề sẽ được chọn từ danh sách này.
descriptions[]

object (AdTextAsset)

Danh sách thành phần văn bản cho nội dung mô tả. Khi quảng cáo phân phát, hệ thống sẽ chọn nội dung mô tả trong danh sách này.
path1

string

Phần đầu tiên của văn bản có thể được thêm vào URL trong quảng cáo.
path2

string

Phần thứ hai của văn bản có thể được nối thêm vào URL trong quảng cáo. Bạn chỉ có thể đặt trường này khi cũng đặt path1.

LegacyResponsiveDisplayAdInfo

Quảng cáo hiển thị thích ứng cũ. Quảng cáo thuộc loại này được gắn nhãn "Quảng cáo thích ứng" trong giao diện người dùng Google Ads.

Biểu diễn dưới dạng JSON 
{
  "formatSetting": enum (DisplayAdFormatSetting),
  "shortHeadline": string,
  "longHeadline": string,
  "description": string,
  "businessName": string,
  "allowFlexibleColor": boolean,
  "accentColor": string,
  "mainColor": string,
  "callToActionText": string,
  "logoImage": string,
  "squareLogoImage": string,
  "marketingImage": string,
  "squareMarketingImage": string,
  "pricePrefix": string,
  "promoText": string
}
Trường
formatSetting

enum (DisplayAdFormatSetting)

Chỉ định định dạng quảng cáo sẽ được phân phát. Mặc định là TẤT CẢ_FORMATS.
shortHeadline

string

Phiên bản ngắn của dòng tiêu đề của quảng cáo.
longHeadline

string

Phiên bản dài của dòng tiêu đề quảng cáo.
description

string

Nội dung mô tả về quảng cáo.
businessName

string

Tên doanh nghiệp trong quảng cáo.
allowFlexibleColor

boolean

Sự đồng ý của nhà quảng cáo để cho phép màu linh hoạt. Khi đúng, quảng cáo có thể được phân phát với màu khác nếu cần. Khi sai, quảng cáo sẽ được phân phát với màu được chỉ định hoặc màu trung tính. Giá trị mặc định là true. Giá trị phải là true nếu bạn chưa đặt mainColor và accentColor.
accentColor

string

Màu nhấn của quảng cáo theo hệ thập lục phân, ví dụ: #ffffff cho màu trắng. Nếu một trong hai giá trị mainColor và accentColor được thiết lập, thì giá trị còn lại cũng là bắt buộc.
mainColor

string

Màu chính của quảng cáo theo hệ thập lục phân, ví dụ: #ffffff cho màu trắng. Nếu một trong hai giá trị mainColor và accentColor được thiết lập, thì giá trị còn lại cũng là bắt buộc.
callToActionText

string

Văn bản lời kêu gọi hành động cho quảng cáo.
logoImage

string

Tên tài nguyên ImageView của hình ảnh biểu trưng được sử dụng trong quảng cáo.
squareLogoImage

string

Tên tài nguyên txt của hình ảnh biểu trưng hình vuông được sử dụng trong quảng cáo.
marketingImage

string

Tên tài nguyên txt của hình ảnh tiếp thị được sử dụng trong quảng cáo.
squareMarketingImage

string

Tên tài nguyên txt của hình ảnh tiếp thị dạng vuông được sử dụng trong quảng cáo.
pricePrefix

string

Tiền tố trước giá. Ví dụ: "as low as".
promoText

string

Văn bản quảng cáo dùng cho các định dạng động của quảng cáo thích ứng. Ví dụ: "Giao hàng miễn phí trong vòng hai ngày".

DisplayAdFormatSetting

Liệt kê các chế độ cài đặt định dạng quảng cáo hiển thị.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Giá trị không xác định trong phiên bản này.
ALL_FORMATS Định dạng văn bản, hình ảnh và định dạng gốc.
NON_NATIVE Định dạng văn bản và hình ảnh.
NATIVE Ví dụ: định dạng gốc là do nhà xuất bản kiểm soát chứ không phải Google kiểm soát việc hiển thị định dạng.

AppAdInfo

Quảng cáo ứng dụng.

Biểu diễn dưới dạng JSON 
{
  "mandatoryAdText": {
    object (AdTextAsset)
  },
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "html5MediaBundles": [
    {
      object (AdMediaBundleAsset)
    }
  ]
}
Trường
mandatoryAdText

object (AdTextAsset)

Văn bản quảng cáo bắt buộc.
headlines[]

object (AdTextAsset)

Danh sách thành phần văn bản cho dòng tiêu đề. Khi quảng cáo phân phát, các dòng tiêu đề sẽ được chọn từ danh sách này.
descriptions[]

object (AdTextAsset)

Danh sách thành phần văn bản cho nội dung mô tả. Khi quảng cáo phân phát, hệ thống sẽ chọn nội dung mô tả trong danh sách này.
images[]

object (AdImageAsset)

Danh sách thành phần hình ảnh có thể hiển thị cùng với quảng cáo.
youtubeVideos[]

object (AdVideoAsset)

Danh sách tài sản video trên YouTube có thể hiển thị cùng với quảng cáo.
html5MediaBundles[]

object (AdMediaBundleAsset)

Danh sách thành phần gói phương tiện có thể sử dụng cùng với quảng cáo.

AdMediaBundleAsset

Thành phần gói phương tiện được dùng trong một quảng cáo.

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

string

Tên tài nguyên Tài sản của gói phương tiện này.

LegacyAppInstallAdInfo

Quảng cáo cài đặt ứng dụng cũ chỉ được sử dụng bởi một số khách hàng được chọn.

Biểu diễn dưới dạng JSON 
{
  "appStore": enum (LegacyAppInstallAdAppStore),
  "appId": string,
  "headline": string,
  "description1": string,
  "description2": string
}
Trường
appStore

enum (LegacyAppInstallAdAppStore)

Cửa hàng ứng dụng có cung cấp ứng dụng di động đó.
appId

string

Mã của ứng dụng di động.
headline

string

Dòng tiêu đề của quảng cáo.
description1

string

Dòng mô tả đầu tiên của quảng cáo.
description2

string

Dòng mô tả thứ hai của quảng cáo.

LegacyAppInstallAdAppStore

Loại cửa hàng ứng dụng trong quảng cáo cài đặt ứng dụng cũ.

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.
APPLE_APP_STORE Apple iTunes.
GOOGLE_PLAY Google Play.
WINDOWS_STORE Windows Store.
WINDOWS_PHONE_STORE Cửa hàng Windows Phone.
CN_APP_STORE Ứng dụng này được lưu trữ trong một cửa hàng ứng dụng của Trung Quốc.

ResponsiveDisplayAdInfo

Quảng cáo hiển thị thích ứng.

Biểu diễn dưới dạng JSON 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareLogoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadline": {
    object (AdTextAsset)
  },
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "formatSetting": enum (DisplayAdFormatSetting),
  "controlSpec": {
    object (ResponsiveDisplayAdControlSpec)
  },
  "businessName": string,
  "mainColor": string,
  "accentColor": string,
  "allowFlexibleColor": boolean,
  "callToActionText": string,
  "pricePrefix": string,
  "promoText": string
}
Trường
marketingImages[]

object (AdImageAsset)

Hình ảnh tiếp thị sẽ được sử dụng trong quảng cáo. Các loại hình ảnh hợp lệ là GIF, JPEG và PNG. Kích thước tối thiểu là 600x314 và tỷ lệ khung hình phải là 1,91:1 (+-1%). Cần có ít nhất một marketingImage. Kết hợp với squareMarketingImages, tối đa là 15.
squareMarketingImages[]

object (AdImageAsset)

Hình ảnh tiếp thị vuông sẽ được sử dụng trong quảng cáo. Các loại hình ảnh hợp lệ là GIF, JPEG và PNG. Kích thước tối thiểu là 300x300 và tỷ lệ khung hình phải là 1:1 (+-1%). Bạn phải có ít nhất một marketingImage vuông. Kết hợp với marketingImages, tối đa là 15.
logoImages[]

object (AdImageAsset)

Hình ảnh biểu trưng sẽ được sử dụng trong quảng cáo. Các loại hình ảnh hợp lệ là GIF, JPEG và PNG. Kích thước tối thiểu là 512 x 128 và tỷ lệ khung hình phải là 4:1 (+-1%). Khi kết hợp với squareLogoImages, giá trị tối đa là 5.
squareLogoImages[]

object (AdImageAsset)

Hình ảnh biểu trưng hình vuông sẽ được sử dụng trong quảng cáo. Các loại hình ảnh hợp lệ là GIF, JPEG và PNG. Kích thước tối thiểu là 128x128 và tỷ lệ khung hình phải là 1:1 (+-1%). Khi kết hợp với logoImages, giá trị tối đa là 5.
headlines[]

object (AdTextAsset)

Dòng tiêu đề có định dạng ngắn cho quảng cáo. Độ dài tối đa là 30 ký tự. Bạn có thể chỉ định ít nhất 1 và tối đa 5 dòng tiêu đề.
longHeadline

object (AdTextAsset)

Dòng tiêu đề bắt buộc phải có định dạng dài. Độ dài tối đa là 90 ký tự.
descriptions[]

object (AdTextAsset)

Văn bản mô tả cho quảng cáo. Độ dài tối đa là 90 ký tự. Bạn có thể chỉ định ít nhất 1 và tối đa 5 dòng tiêu đề.
youtubeVideos[]

object (AdVideoAsset)

Video không bắt buộc trên YouTube cho quảng cáo. Bạn có thể chỉ định tối đa 5 video.
formatSetting

enum (DisplayAdFormatSetting)

Chỉ định định dạng quảng cáo sẽ được phân phát. Mặc định là TẤT CẢ_FORMATS.
controlSpec

object (ResponsiveDisplayAdControlSpec)

Thông số kỹ thuật cho các biện pháp kiểm soát mẫu quảng cáo.
businessName

string

Tên nhà quảng cáo/thương hiệu. Chiều rộng hiển thị tối đa là 25.
mainColor

string

Màu chính của quảng cáo theo hệ thập lục phân, ví dụ: #ffffff cho màu trắng. Nếu một trong hai giá trị mainColor và accentColor được thiết lập, thì giá trị còn lại cũng là bắt buộc.
accentColor

string

Màu nhấn của quảng cáo theo hệ thập lục phân, ví dụ: #ffffff cho màu trắng. Nếu một trong hai giá trị mainColor và accentColor được thiết lập, thì giá trị còn lại cũng là bắt buộc.
allowFlexibleColor

boolean

Sự đồng ý của nhà quảng cáo để cho phép màu linh hoạt. Khi đúng, quảng cáo có thể được phân phát với màu khác nếu cần. Khi sai, quảng cáo sẽ được phân phát với màu được chỉ định hoặc màu trung tính. Giá trị mặc định là true. Giá trị phải là true nếu bạn chưa đặt mainColor và accentColor.
callToActionText

string

Văn bản lời kêu gọi hành động cho quảng cáo. Chiều rộng hiển thị tối đa là 30.
pricePrefix

string

Tiền tố trước giá. Ví dụ: "as low as".
promoText

string

Văn bản quảng cáo dùng cho các định dạng động của quảng cáo thích ứng. Ví dụ: "Giao hàng miễn phí trong vòng hai ngày".

ResponsiveDisplayAdControlSpec

Thông số kỹ thuật cho các chế độ kiểm soát mẫu quảng cáo trong quảng cáo hiển thị thích ứng.

Biểu diễn dưới dạng JSON 
{
  "enableAssetEnhancements": boolean,
  "enableAutogenVideo": boolean
}
Trường
enableAssetEnhancements

boolean

Nhà quảng cáo có chọn sử dụng tính năng nâng cao thành phần hay không.
enableAutogenVideo

boolean

Liệu nhà quảng cáo có chọn sử dụng tính năng video tự động tạo hay không.

LocalAdInfo

Quảng cáo địa phương.

Biểu diễn dưới dạng JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "path1": string,
  "path2": string
}
Trường
headlines[]

object (AdTextAsset)

Danh sách thành phần văn bản cho dòng tiêu đề. Khi quảng cáo phân phát, các dòng tiêu đề sẽ được chọn từ danh sách này. Bạn phải chỉ định ít nhất 1 và tối đa 5 dòng tiêu đề.
descriptions[]

object (AdTextAsset)

Danh sách thành phần văn bản cho nội dung mô tả. Khi quảng cáo phân phát, hệ thống sẽ chọn nội dung mô tả trong danh sách này. Bạn phải chỉ định ít nhất 1 và tối đa 5 dòng mô tả.
callToActions[]

object (AdTextAsset)

Danh sách thành phần văn bản cho lời kêu gọi hành động. Khi quảng cáo phân phát, lời kêu gọi hành động sẽ được chọn từ danh sách này. Bạn phải chỉ định ít nhất 1 và tối đa 5 lời kêu gọi hành động.
marketingImages[]

object (AdImageAsset)

Danh sách thành phần hình ảnh tiếp thị có thể hiển thị cùng với quảng cáo. Hình ảnh phải có kích thước 314x600 pixel hoặc 320x320 pixel. Bạn phải chỉ định ít nhất 1 và tối đa 20 thành phần hình ảnh.
logoImages[]

object (AdImageAsset)

Danh sách thành phần hình ảnh biểu trưng có thể hiển thị cùng với quảng cáo. Hình ảnh phải có kích thước 128x128 pixel và không lớn hơn 120KB. Bạn phải chỉ định ít nhất 1 và tối đa 5 thành phần hình ảnh.
videos[]

object (AdVideoAsset)

Danh sách tài sản video trên YouTube có thể hiển thị cùng với quảng cáo. Bạn phải chỉ định ít nhất 1 và tối đa 20 thành phần video.
path1

string

Phần đầu tiên của văn bản tùy chọn có thể được thêm vào URL trong quảng cáo.
path2

string

Phần thứ hai của văn bản không bắt buộc có thể được nối thêm vào URL trong quảng cáo. Bạn chỉ có thể đặt trường này khi cũng đặt path1.

DisplayUploadAdInfo

Một loại quảng cáo hiển thị chung. Định dạng quảng cáo chính xác do trường displayUploadProductType kiểm soát. Trường này xác định loại dữ liệu nào cần có trong quảng cáo.

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

  // Union field media_asset can be only one of the following:
  "mediaBundle": {
    object (AdMediaBundleAsset)
  }
  // End of list of possible types for union field media_asset.
}
Trường
displayUploadProductType

enum (DisplayUploadProductType)

Loại sản phẩm của quảng cáo này. Xem nhận xét về enum để biết thông tin chi tiết.
Trường hợp media_asset. Dữ liệu về thành phần tạo nên quảng cáo. media_asset chỉ có thể là một trong những trạng thái sau:
mediaBundle

object (AdMediaBundleAsset)

Thành phần gói phương tiện sẽ được dùng trong quảng cáo. Để biết thông tin về gói phương tiện cho HTML5_UPLOAD_AD, hãy xem https://support.google.com/google-ads/answer/1722096 Các gói phương tiện thuộc các loại sản phẩm động sử dụng định dạng đặc biệt cần được tạo thông qua Google Web Designer. Hãy tham khảo https://support.google.com/webdesigner/answer/7543898 để biết thêm thông tin.

DisplayUploadProductType

Liệt kê các loại sản phẩm tải lên hiển thị.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Giá trị không xác định trong phiên bản này.
HTML5_UPLOAD_AD Quảng cáo tải lên HTML5. Loại sản phẩm này yêu cầu phải đặt trường upload_media_bundle trong DisplayUploadAdInfo.
DYNAMIC_HTML5_EDUCATION_AD Quảng cáo giáo dục HTML5 động. Loại sản phẩm này yêu cầu phải đặt trường upload_media_bundle trong DisplayUploadAdInfo. Chỉ có thể dùng trong chiến dịch giáo dục.
DYNAMIC_HTML5_FLIGHT_AD Quảng cáo chuyến bay HTML5 động. Loại sản phẩm này yêu cầu phải đặt trường upload_media_bundle trong DisplayUploadAdInfo. Chỉ có thể dùng trong chiến dịch quảng cáo chuyến bay.
DYNAMIC_HTML5_HOTEL_RENTAL_AD Quảng cáo khách sạn và cho thuê HTML5 động. Loại sản phẩm này yêu cầu phải đặt trường upload_media_bundle trong DisplayUploadAdInfo. Chỉ có thể sử dụng trong chiến dịch Khách sạn.
DYNAMIC_HTML5_JOB_AD Quảng cáo việc làm HTML5 động. Loại sản phẩm này yêu cầu phải đặt trường upload_media_bundle trong DisplayUploadAdInfo. Chỉ có thể sử dụng trong chiến dịch việc làm.
DYNAMIC_HTML5_LOCAL_AD Quảng cáo địa phương HTML5 động. Loại sản phẩm này yêu cầu phải đặt trường upload_media_bundle trong DisplayUploadAdInfo. Chỉ có thể dùng trong chiến dịch địa phương.
DYNAMIC_HTML5_REAL_ESTATE_AD Quảng cáo bất động sản HTML5 động. Loại sản phẩm này yêu cầu phải đặt trường upload_media_bundle trong DisplayUploadAdInfo. Chỉ có thể sử dụng trong chiến dịch bất động sản.
DYNAMIC_HTML5_CUSTOM_AD Quảng cáo tuỳ chỉnh HTML5 động. Loại sản phẩm này yêu cầu phải đặt trường upload_media_bundle trong DisplayUploadAdInfo. Chỉ có thể dùng trong chiến dịch tuỳ chỉnh.
DYNAMIC_HTML5_TRAVEL_AD Quảng cáo du lịch HTML5 động. Loại sản phẩm này yêu cầu phải đặt trường upload_media_bundle trong DisplayUploadAdInfo. Chỉ có thể dùng trong chiến dịch du lịch.
DYNAMIC_HTML5_HOTEL_AD Quảng cáo khách sạn HTML5 động. Loại sản phẩm này yêu cầu phải đặt trường upload_media_bundle trong DisplayUploadAdInfo. Chỉ có thể sử dụng trong chiến dịch Khách sạn.

AppEngagementAdInfo

Quảng cáo tương tác với ứng dụng cho phép bạn viết văn bản khuyến khích một hành động cụ thể trong ứng dụng, chẳng hạn như đăng ký, mua hàng hoặc đặt vé máy bay. Chúng cho phép bạn đưa người dùng đến một phần cụ thể trong ứng dụng, nơi họ có thể tìm thấy nội dung họ đang tìm một cách dễ dàng và nhanh chóng hơn.

Biểu diễn dưới dạng JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ]
}
Trường
headlines[]

object (AdTextAsset)

Danh sách thành phần văn bản cho dòng tiêu đề. Khi quảng cáo phân phát, các dòng tiêu đề sẽ được chọn từ danh sách này.
descriptions[]

object (AdTextAsset)

Danh sách thành phần văn bản cho nội dung mô tả. Khi quảng cáo phân phát, hệ thống sẽ chọn nội dung mô tả trong danh sách này.
images[]

object (AdImageAsset)

Danh sách thành phần hình ảnh có thể hiển thị cùng với quảng cáo.
videos[]

object (AdVideoAsset)

Danh sách thành phần video có thể hiển thị cùng với quảng cáo.

ShoppingComparisonListingAdInfo

Quảng cáo danh sách so sánh mua sắm.

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

string

Dòng tiêu đề của quảng cáo. Trường này là bắt buộc. Độ dài cho phép là từ 25 đến 45 ký tự.

SmartCampaignAdInfo

Quảng cáo thuộc chiến dịch Thông minh.

Biểu diễn dưới dạng JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ]
}
Trường
headlines[]

object (AdTextAsset)

Danh sách thành phần văn bản, mỗi thành phần tương ứng với một dòng tiêu đề khi quảng cáo phân phát. Danh sách này bao gồm tối thiểu 3 và tối đa 15 thành phần văn bản.
descriptions[]

object (AdTextAsset)

Danh sách thành phần văn bản, mỗi thành phần tương ứng với một nội dung mô tả khi quảng cáo phân phát. Danh sách này bao gồm tối thiểu 2 và tối đa 4 thành phần văn bản.

AppPreRegistrationAdInfo

Quảng cáo đăng ký trước ứng dụng liên kết đến trang thông tin ứng dụng hoặc trò chơi của bạn trên Google Play và có thể chạy trên Google Play, trên YouTube (chỉ trong luồng phát), cũng như trong các ứng dụng và trang web dành cho thiết bị di động khác trên Mạng Hiển thị. Việc này sẽ giúp thu hút sự quan tâm của mọi người đến ứng dụng hoặc trò chơi của bạn và tạo số lượt cài đặt sớm cho ứng dụng/trò chơi trước thời điểm phát hành.

Biểu diễn dưới dạng JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ]
}
Trường
headlines[]

object (AdTextAsset)

Danh sách thành phần văn bản cho dòng tiêu đề. Khi quảng cáo phân phát, các dòng tiêu đề sẽ được chọn từ danh sách này.
descriptions[]

object (AdTextAsset)

Danh sách thành phần văn bản cho nội dung mô tả. Khi quảng cáo phân phát, hệ thống sẽ chọn nội dung mô tả trong danh sách này.
images[]

object (AdImageAsset)

Danh sách mã thành phần hình ảnh có hình ảnh có thể xuất hiện cùng với quảng cáo.
youtubeVideos[]

object (AdVideoAsset)

Danh sách mã tài sản video trên YouTube chứa video có thể xuất hiện cùng với quảng cáo.

DiscoveryMultiAssetAdInfo

Quảng cáo khám phá nhiều thành phần.

Biểu diễn dưới dạng JSON 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "businessName": string,
  "callToActionText": string,
  "leadFormOnly": boolean
}
Trường
marketingImages[]

object (AdImageAsset)

Thành phần hình ảnh tiếp thị sẽ được sử dụng trong quảng cáo. Các loại hình ảnh hợp lệ là GIF, JPEG và PNG. Kích thước tối thiểu là 600x314 và tỷ lệ khung hình phải là 1,91:1 (+-1%). Bắt buộc nếu không có hình SquareMarketingImages. Kết hợp với squareMarketingImages và portraitMarketingImages thì tối đa là 20.
squareMarketingImages[]

object (AdImageAsset)

Thành phần hình ảnh tiếp thị hình vuông sẽ được sử dụng trong quảng cáo này. Các loại hình ảnh hợp lệ là GIF, JPEG và PNG. Kích thước tối thiểu là 300x300 và tỷ lệ khung hình phải là 1:1 (+-1%). Bắt buộc nếu không có MarketingImages. Kết hợp với marketingImages và portraitMarketingImages thì tối đa là 20.
portraitMarketingImages[]

object (AdImageAsset)

Thành phần hình ảnh tiếp thị thẳng đứng sẽ được sử dụng trong quảng cáo. Các loại hình ảnh hợp lệ là GIF, JPEG và PNG. Kích thước tối thiểu là 480x600 và tỷ lệ khung hình phải là 4:5 (+-1%). Kết hợp với marketingImages và squareMarketingImages thì tối đa là 20.
logoImages[]

object (AdImageAsset)

Thành phần hình ảnh biểu trưng sẽ được sử dụng trong quảng cáo. Các loại hình ảnh hợp lệ là GIF, JPEG và PNG. Kích thước tối thiểu là 128x128 và tỷ lệ khung hình phải là 1:1 (+-1%). Bạn có thể chỉ định ít nhất 1 và tối đa 5 hình ảnh biểu trưng.
headlines[]

object (AdTextAsset)

Thành phần văn bản dòng tiêu đề của quảng cáo. Chiều rộng hiển thị tối đa là 30. Bạn có thể chỉ định ít nhất 1 và tối đa 5 dòng tiêu đề.
descriptions[]

object (AdTextAsset)

Văn bản mô tả của quảng cáo. Chiều rộng hiển thị tối đa là 90. Bạn có thể chỉ định ít nhất 1 và tối đa 5 nội dung mô tả.
businessName

string

Tên thương hiệu/nhà quảng cáo. Chiều rộng hiển thị tối đa là 25. Bắt buộc.
callToActionText

string

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

boolean

Tuỳ chọn Boolean cho biết liệu quảng cáo này có phải được phân phát cùng với biểu mẫu khách hàng tiềm năng hay không.

DiscoveryCarouselAdInfo

Quảng cáo khám phá dạng băng chuyền.

Biểu diễn dưới dạng JSON 
{
  "businessName": string,
  "logoImage": {
    object (AdImageAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "callToActionText": string,
  "carouselCards": [
    {
      object (AdDiscoveryCarouselCardAsset)
    }
  ]
}
Trường
businessName

string

Bắt buộc. Tên thương hiệu/nhà quảng cáo.
logoImage

object (AdImageAsset)

Bắt buộc. Hình ảnh biểu trưng sẽ được sử dụng trong quảng cáo. Kích thước tối thiểu là 128x128 và tỷ lệ khung hình phải là 1:1 (+-1%).
headline

object (AdTextAsset)

Bắt buộc. Dòng tiêu đề của quảng cáo.
description

object (AdTextAsset)

Bắt buộc. Văn bản mô tả của quảng cáo.
callToActionText

string

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

object (AdDiscoveryCarouselCardAsset)

Bắt buộc. Thẻ băng chuyền sẽ hiển thị cùng với quảng cáo. Tối thiểu 2 và tối đa 10.

AdDiscoveryCarouselCardAsset

Thành phần thẻ băng chuyền Khám phá được dùng trong quảng cáo.

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

string

Tên tài nguyên thành phần của thẻ băng chuyền khám phá này.

DiscoveryVideoResponsiveAdInfo

Quảng cáo khám phá dạng video thích ứng.

Biểu diễn dưới dạng JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "callToActions": [
    {
      object (AdCallToActionAsset)
    }
  ]
}
Trường
headlines[]

object (AdTextAsset)

Danh sách thành phần văn bản được dùng cho dòng tiêu đề ngắn.
longHeadlines[]

object (AdTextAsset)

Danh sách thành phần văn bản được dùng cho dòng tiêu đề dài.
descriptions[]

object (AdTextAsset)

Danh sách thành phần văn bản được dùng cho nội dung mô tả.
videos[]

object (AdVideoAsset)

Danh sách tài sản video trên YouTube được dùng cho quảng cáo.
logoImages[]

object (AdImageAsset)

Hình ảnh biểu trưng sẽ được sử dụng trong quảng cáo. Các loại hình ảnh hợp lệ là GIF, JPEG và PNG. Kích thước tối thiểu là 128x128 và tỷ lệ khung hình phải là 1:1 (+-1%).
breadcrumb1

string

Phần đầu tiên của văn bản xuất hiện trong quảng cáo cùng với URL hiển thị.
breadcrumb2

string

Phần thứ hai của văn bản xuất hiện trong quảng cáo cùng với URL hiển thị.
businessName

object (AdTextAsset)

Bắt buộc. Tên nhà quảng cáo/thương hiệu.
callToActions[]

object (AdCallToActionAsset)

Thành phần thuộc loại CallToActionAsset dùng cho nút "Call To Action" (Lời kêu gọi hành động).

AdCallToActionAsset

Thành phần lời kêu gọi hành động được dùng trong quảng cáo.

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

string

Tên tài nguyên của thành phần lời kêu gọi hành động này.

TravelAdInfo

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

Quảng cáo du lịch.

Phương thức

get

 Trả về quảng cáo được yêu cầu một cách đầy đủ chi tiết.

mutate

 Cập nhật quảng cáo.