REST Resource: advertisers.adGroupAds

Tài nguyên: AdGroupAd

Một quảng cáo được liên kết với một nhóm quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupAdId": string,
  "adGroupId": string,
  "displayName": string,
  "adPolicy": {
    object (AdPolicy)
  },
  "entityStatus": enum (EntityStatus),
  "adUrls": [
    {
      object (AdUrl)
    }
  ],
  "dcmTrackingInfo": {
    object (DcmTrackingInfo)
  },
  "containsSyntheticMedia": boolean,
  "parentCreativeId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  },
  "demandGenVideoAd": {
    object (DemandGenVideoAd)
  },
  "demandGenImageAd": {
    object (DemandGenImageAd)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAd)
  },
  "demandGenProductAd": {
    object (DemandGenProductAd)
  }
  // End of mutually exclusive fields.
}
Trường
name

string

Chỉ có đầu ra. Tên tài nguyên của quảng cáo.
advertiserId

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng duy nhất của nhà quảng cáo sở hữu quảng cáo.
adGroupAdId

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng duy nhất của quảng cáo. Do hệ thống chỉ định.
adGroupId

string (int64 format)

Bắt buộc. Không thể thay đổi. Mã nhận dạng duy nhất của nhóm quảng cáo chứa quảng cáo.
displayName

string

Bắt buộc. Tên hiển thị của quảng cáo.

Phải được mã hoá UTF-8 với kích thước tối đa là 255 byte.
adPolicy

object (AdPolicy)

Chỉ có đầu ra. Trạng thái phê duyệt chính sách của quảng cáo.
entityStatus

enum (EntityStatus)

Bắt buộc. Trạng thái thực thể của quảng cáo.
adUrls[]

object (AdUrl)

Chỉ có đầu ra. Danh sách URL mà quảng cáo sử dụng.
dcmTrackingInfo

object (DcmTrackingInfo)

Không bắt buộc. Thông tin quảng cáo được theo dõi DCM.

Để xoá thông tin quảng cáo theo dõi DCM, vui lòng để trống trường này.
containsSyntheticMedia

boolean

Không bắt buộc. Cho biết liệu quảng cáo có chứa nội dung nghe nhìn đã được chỉnh sửa hoặc giả tạo hay không.

Chỉ nên đặt cho quảng cáo do nhà quảng cáo bầu cử đã xác minh tạo. Chỉ áp dụng cho quảng cáo trên YouTube.
parentCreativeId

string (int64 format)

Chỉ có đầu ra. Mã của mẫu quảng cáo trên Display & Video 360 được dùng để tạo quảng cáo này.

Trường này sẽ chỉ được điền cho những quảng cáo được tạo từ mẫu quảng cáo được chỉ định cho nhóm quảng cáo gốc.
Thông tin chi tiết về quảng cáo. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
displayVideoSourceAd

object (DisplayVideoSourceAd)

Chỉ có đầu ra. Thông tin chi tiết về một quảng cáo được lấy từ mẫu quảng cáo Display & Video 360.
mastheadAd

object (MastheadAd)

Chỉ có đầu ra. Thông tin chi tiết về quảng cáo được phân phát trên danh sách video trên Trang chủ của YouTube.
inStreamAd

object (InStreamAd)

Chỉ có đầu ra. Thông tin chi tiết về quảng cáo trong luồng phát có thể bỏ qua sau 5 giây, được dùng cho mục tiêu tiếp thị là nâng cao mức độ nhận biết thương hiệu hoặc phạm vi tiếp cận.
nonSkippableAd

object (NonSkippableAd)

Chỉ có đầu ra. Thông tin chi tiết về quảng cáo dạng video trong luồng phát không thể bỏ qua, có thời lượng từ 6 đến 15 giây, được dùng cho các mục tiêu tiếp thị về phạm vi tiếp cận.
bumperAd

object (BumperAd)

Chỉ có đầu ra. Thông tin chi tiết về quảng cáo dạng video ngắn không thể bỏ qua, có thời lượng từ 6 giây trở xuống, dùng để tăng phạm vi tiếp cận.
audioAd

object (AudioAd)

Chỉ có đầu ra. Thông tin chi tiết về quảng cáo dạng âm thanh được dùng để đạt được mục tiêu tiếp thị về phạm vi tiếp cận.
videoDiscoverAd

object (VideoDiscoveryAd)

Chỉ có đầu ra. Thông tin chi tiết về một quảng cáo quảng bá video xuất hiện ở những nơi khám phá.
videoPerformanceAd

object (VideoPerformanceAd)

Chỉ có đầu ra. Thông tin chi tiết về quảng cáo được dùng trong chiến dịch Video thúc đẩy hành động để thúc đẩy hành động cho doanh nghiệp, dịch vụ hoặc sản phẩm.
demandGenVideoAd

object (DemandGenVideoAd)

Không bắt buộc. Thông tin chi tiết về quảng cáo Tạo nhu cầu dạng video.
demandGenImageAd

object (DemandGenImageAd)

Không bắt buộc. Thông tin chi tiết về quảng cáo dạng hình ảnh trong chiến dịch Tạo nhu cầu.
demandGenProductAd

object (DemandGenProductAd)

Không bắt buộc. Thông tin chi tiết về quảng cáo sản phẩm Tạo nhu cầu.
Kết thúc các trường loại trừ lẫn nhau.

DisplayVideoSourceAd

Quảng cáo lấy từ mẫu quảng cáo trên DV360.

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

string (int64 format)

Mã của mẫu quảng cáo nguồn.

MastheadAd

Thông tin chi tiết về quảng cáo trên đầu trang chủ.

Biểu diễn dưới dạng JSON 
{
  "video": {
    object (YoutubeVideoDetails)
  },
  "headline": string,
  "description": string,
  "videoAspectRatio": enum (VideoAspectRatio),
  "autoplayVideoStartMillisecond": string,
  "autoplayVideoDuration": string,
  "callToActionButtonLabel": string,
  "callToActionFinalUrl": string,
  "callToActionTrackingUrl": string,
  "showChannelArt": boolean,
  "companionYoutubeVideos": [
    {
      object (YoutubeVideoDetails)
    }
  ]
}
Trường
video

object (YoutubeVideoDetails)

Video trên YouTube mà quảng cáo sử dụng.
headline

string

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

string

Nội dung mô tả của quảng cáo.
videoAspectRatio

enum (VideoAspectRatio)

Tỷ lệ khung hình của video trên YouTube tự động phát trong Quảng cáo trên đầu trang chủ.
autoplayVideoStartMillisecond

string (int64 format)

Khoảng thời gian tính bằng mili giây sau đó video sẽ bắt đầu phát.
autoplayVideoDuration

string (Duration format)

Thời lượng video sẽ tự động phát.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
callToActionButtonLabel

string

Văn bản trên nút kêu gọi hành động.
callToActionFinalUrl

string

URL đích cho nút kêu gọi hành động.
callToActionTrackingUrl

string

URL theo dõi cho nút kêu gọi hành động.
showChannelArt

boolean

Có hiển thị hình nền hoặc biểu ngữ ở đầu trang YouTube hay không.
companionYoutubeVideos[]

object (YoutubeVideoDetails)

Video xuất hiện bên cạnh Quảng cáo trên đầu trang chủ trên máy tính. Không được quá hai.

YoutubeVideoDetails

Thông tin chi tiết về một video trên YouTube.

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason),
  "videoAssetId": string
}
Trường
id

string

Chỉ có đầu ra. Mã video trên YouTube có thể tìm kiếm được trên trang web YouTube.
unavailableReason

enum (VideoUnavailableReason)

Chỉ có đầu ra. Lý do không có dữ liệu video.
videoAssetId

string (int64 format)

Bắt buộc. Mã thành phần video trên YouTube. Đây là adAssetId của tài nguyên AdAsset.

VideoUnavailableReason

Các lý do có thể khiến video không xem được.

Enum
VIDEO_UNAVAILABLE_REASON_UNSPECIFIED Không xác định hoặc không được chỉ định.
VIDEO_UNAVAILABLE_REASON_PRIVATE Video này ở chế độ riêng tư.
VIDEO_UNAVAILABLE_REASON_DELETED Video đã bị xoá.

VideoAspectRatio

Các tỷ lệ khung hình có thể có cho video trên YouTube.

Enum
VIDEO_ASPECT_RATIO_UNSPECIFIED Không được chỉ định hoặc không xác định.
VIDEO_ASPECT_RATIO_WIDESCREEN Video bị kéo giãn và phần trên cùng cũng như dưới cùng bị cắt bớt.
VIDEO_ASPECT_RATIO_FIXED_16_9 Video sử dụng tỷ lệ khung hình cố định là 16:9.

InStreamAd

Thông tin chi tiết về quảng cáo trong luồng phát.

Biểu diễn dưới dạng JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
Trường
commonInStreamAttribute

object (CommonInStreamAttribute)

Bắt buộc. Các thuộc tính quảng cáo phổ biến.
customParameters

map (key: string, value: string)

Không bắt buộc. Các tham số tuỳ chỉnh và giá trị đi kèm để thêm vào URL theo dõi.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

CommonInStreamAttribute

Các thuộc tính phổ biến cho quảng cáo trong luồng phát, quảng cáo không thể bỏ qua và quảng cáo đệm.

Biểu diễn dưới dạng JSON 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
Trường
displayUrl

string

Bắt buộc. Địa chỉ trang web xuất hiện cùng với quảng cáo.
finalUrl

string

Bắt buộc. Địa chỉ URL của trang web mà mọi người sẽ được chuyển đến sau khi nhấp vào quảng cáo.
trackingUrl

string

Chỉ có đầu ra. Địa chỉ URL được tải trong nền cho mục đích theo dõi.

Trong phiên bản 4 trở xuống, trường này đại diện cho URL theo dõi do người dùng chỉ định theo cách thủ công. Bạn có thể tìm thấy thông tin này tại userSpecifiedTrackingUrl trong phiên bản 5.
userSpecifiedTrackingUrl

string

Không bắt buộc. URL theo dõi do người dùng chỉ định theo cách thủ công.
actionButtonLabel

string

Không bắt buộc. Văn bản trên nút kêu gọi hành động.

Phải được đặt nếu actionHeadline được đặt.
actionHeadline

string

Không bắt buộc. Dòng tiêu đề của biểu ngữ kêu gọi hành động.
video

object (YoutubeVideoDetails)

Bắt buộc. Không thể thay đổi. Video trên YouTube của quảng cáo.
companionBanner

object (ImageAsset)

Không bắt buộc. Hình ảnh xuất hiện bên cạnh quảng cáo dạng video.

ImageAsset

Siêu dữ liệu của thành phần hình ảnh.

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

string

Chỉ có đầu ra. Loại MIME của thành phần hình ảnh.
fullSize

object (Dimensions)

Chỉ có đầu ra. Siêu dữ liệu cho hình ảnh này ở kích thước gốc.
fileSize

string (int64 format)

Chỉ có đầu ra. Kích thước tệp của thành phần hình ảnh, tính bằng byte.
assetId

string (int64 format)

Bắt buộc. Mã nhận dạng duy nhất của tài sản.

NonSkippableAd

Thông tin về quảng cáo không thể bỏ qua.

Biểu diễn dưới dạng JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
Trường
commonInStreamAttribute

object (CommonInStreamAttribute)

Bắt buộc. Các thuộc tính quảng cáo phổ biến.
customParameters

map (key: string, value: string)

Không bắt buộc. Các tham số tuỳ chỉnh và giá trị đi kèm để thêm vào URL theo dõi.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

BumperAd

Thông tin về quảng cáo đệm.

Biểu diễn dưới dạng JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}
Trường
commonInStreamAttribute

object (CommonInStreamAttribute)

Bắt buộc. Các thuộc tính quảng cáo phổ biến.

AudioAd

Thông tin chi tiết về quảng cáo dạng âm thanh.

Biểu diễn dưới dạng JSON 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
Trường
displayUrl

string

Địa chỉ trang web xuất hiện cùng với quảng cáo.
finalUrl

string

Địa chỉ URL của trang web mà mọi người sẽ được chuyển đến sau khi nhấp vào quảng cáo.
trackingUrl

string

Địa chỉ URL được tải trong nền cho mục đích theo dõi.

Trong phiên bản 4 trở xuống, trường này đại diện cho URL theo dõi do người dùng chỉ định theo cách thủ công. Bạn có thể tìm thấy thông tin này tại userSpecifiedTrackingUrl trong phiên bản 5.
userSpecifiedTrackingUrl

string

Không bắt buộc. URL theo dõi do người dùng chỉ định theo cách thủ công.
video

object (YoutubeVideoDetails)

Video trên YouTube của quảng cáo.

VideoDiscoveryAd

Thông tin chi tiết về quảng cáo khám phá dạng video.

Biểu diễn dưới dạng JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}
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 cho quảng cáo.
description2

string

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

object (YoutubeVideoDetails)

Video trên YouTube mà quảng cáo quảng bá.
thumbnail

enum (Thumbnail)

Hình thu nhỏ được dùng trong quảng cáo.

Hình thu nhỏ

Các lựa chọn hình thu nhỏ có thể có trong Quảng cáo khám phá dạng video.

Enum
THUMBNAIL_UNSPECIFIED Không xác định hoặc không được chỉ định.
THUMBNAIL_DEFAULT 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.

VideoPerformanceAd

Thông tin chi tiết về quảng cáo video dựa trên hiệu suất.

Biểu diễn dưới dạng JSON 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "actionButtonLabels": [
    string
  ],
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "domain": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanners": [
    {
      object (ImageAsset)
    }
  ],
  "businessName": string,
  "logo": {
    object (ImageAsset)
  }
}
Trường
finalUrl

string

Bắt buộc. Địa chỉ URL của trang web mà mọi người sẽ được chuyển đến sau khi nhấp vào quảng cáo.
trackingUrl

string

Chỉ có đầu ra. Địa chỉ URL được tải trong nền cho mục đích theo dõi.

Trong phiên bản 4 trở xuống, trường này đại diện cho URL theo dõi do người dùng chỉ định theo cách thủ công. Bạn có thể tìm thấy thông tin này tại userSpecifiedTrackingUrl trong phiên bản 5.
userSpecifiedTrackingUrl

string

Không bắt buộc. URL theo dõi do người dùng chỉ định theo cách thủ công.
actionButtonLabels[]

string

Không bắt buộc. Danh sách thành phần văn bản xuất hiện trên nút kêu gọi hành động.

Phải được đặt nếu headlines được đặt.
headlines[]

string

Không bắt buộc. Danh sách dòng tiêu đề xuất hiện trên biểu ngữ lời kêu gọi hành động.
longHeadlines[]

string

Không bắt buộc. Danh sách dòng tiêu đề dài xuất hiện trên biểu ngữ lời kêu gọi hành động.

Phải được đặt trừ phi lineItemType của mục hàng mẹ là LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE, trong trường hợp này, bạn không thể đặt trường này.
descriptions[]

string

Không bắt buộc. Danh sách nội dung mô tả xuất hiện trên biểu ngữ lời kêu gọi hành động.

Phải được đặt trừ phi lineItemType của mục hàng mẹ là LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE, trong trường hợp này, bạn không thể đặt trường này.
displayUrlBreadcrumb1

string

Không bắt buộc. Phần đầu tiên sau miền trong URL hiển thị.
displayUrlBreadcrumb2

string

Không bắt buộc. Phần thứ hai sau miền trong URL hiển thị.

Chỉ có thể đặt nếu bạn cũng đặt displayUrlBreadcrumb1.
domain

string

Chỉ có đầu ra. Miền của URL hiển thị.
videos[]

object (YoutubeVideoDetails)

Bắt buộc. Danh sách thành phần video trên YouTube mà quảng cáo này sử dụng.
customParameters

map (key: string, value: string)

Không bắt buộc. Các tham số tuỳ chỉnh và giá trị đi kèm để thêm vào URL theo dõi.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
companionBanners[]

object (ImageAsset)

Không bắt buộc. Danh sách biểu ngữ đi kèm mà quảng cáo này sử dụng.
businessName

string

Không bắt buộc. Tên doanh nghiệp xuất hiện trên quảng cáo.

Bạn phải đặt chế độ cài đặt này, trừ phi đã đặt giá trị mặc định ở cấp nhà quảng cáo. Nếu bạn không đặt, giá trị mặc định sẽ được áp dụng.

DemandGenVideoAd

Thông tin chi tiết về quảng cáo Tạo nhu cầu dạng video.

Biểu diễn dưới dạng JSON 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": enum (CallToAction),
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanner": {
    object (ImageAsset)
  },
  "logo": {
    object (ImageAsset)
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string
}
Trường
finalUrl

string

Bắt buộc. Địa chỉ URL của trang web mà mọi người sẽ được chuyển đến sau khi nhấp vào quảng cáo.
trackingUrl

string

Chỉ có đầu ra. Địa chỉ URL được tải trong nền cho mục đích theo dõi.
userSpecifiedTrackingUrl

string

Không bắt buộc. URL theo dõi do người dùng chỉ định theo cách thủ công.
callToAction

enum (CallToAction)

Bắt buộc. Nút kêu gọi hành động xuất hiện trên quảng cáo.

Sau đây là các giá trị được hỗ trợ:

  • AUTOMATED
  • LEARN_MORE
  • GET_QUOTE
  • APPLY_NOW
  • SIGN_UP
  • CONTACT_US
  • SUBSCRIBE
  • DOWNLOAD
  • BOOK_NOW
  • SHOP_NOW
  • BUY_NOW
  • DONATE_NOW
  • ORDER_NOW
  • PLAY_NOW
  • SEE_MORE
  • START_NOW
  • VISIT_SITE
  • WATCH_NOW
headlines[]

string

Bắt buộc. Danh sách dòng tiêu đề xuất hiện trên quảng cáo.
longHeadlines[]

string

Bắt buộc. Danh sách các dòng tiêu đề dài xuất hiện trên quảng cáo.
descriptions[]

string

Bắt buộc. Danh sách nội dung mô tả xuất hiện trên quảng cáo.
displayUrlBreadcrumb1

string

Không bắt buộc. Phần đầu tiên sau miền trong URL hiển thị.
displayUrlBreadcrumb2

string

Không bắt buộc. Phần thứ hai sau miền trong URL hiển thị.
videos[]

object (YoutubeVideoDetails)

Bắt buộc. Danh sách thành phần video trên YouTube mà quảng cáo này sử dụng.
customParameters

map (key: string, value: string)

Không bắt buộc. Các tham số tuỳ chỉnh và giá trị đi kèm để thêm vào URL theo dõi.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
companionBanner

object (ImageAsset)

Không bắt buộc. Biểu ngữ đi kèm mà quảng cáo này sử dụng.
finalMobileUrl

string

Không bắt buộc. Địa chỉ URL của trang web mà mọi người sẽ được chuyển đến sau khi nhấp vào quảng cáo trên thiết bị di động.
finalUrlSuffix

string

Không bắt buộc. Hậu tố cần thêm vào URL trang đích.
businessName

string

Không bắt buộc. Tên doanh nghiệp xuất hiện trên quảng cáo.

Bạn phải đặt chế độ cài đặt này, trừ phi đã đặt giá trị mặc định ở cấp nhà quảng cáo. Nếu bạn không đặt, giá trị mặc định sẽ được áp dụng.

CallToAction

Các giá trị có thể có của lời kêu gọi hành động cho quảng cáo Tạo nhu cầu cho sản phẩm/dạng video.

Enum
CALL_TO_ACTION_UNSPECIFIED Không được chỉ định hoặc không xác định.
AUTOMATED Tự động.
LEARN_MORE Tìm hiểu thêm.
GET_QUOTE Nhận báo giá.
APPLY_NOW Đăng ký ngay.
SIGN_UP Đăng ký.
CONTACT_US Liên hệ với chúng tôi.
SUBSCRIBE Đăng ký.
DOWNLOAD Tải xuống.
BOOK_NOW Đặt ngay.
SHOP_NOW Mua ngay nào!
BUY_NOW Mua ngay bây giờ.
DONATE_NOW Đóng góp ngay.
ORDER_NOW Đặt hàng ngay.
PLAY_NOW Chơi ngay.
SEE_MORE Xem thêm.
START_NOW Bắt đầu ngay.
VISIT_SITE Truy cập trang web.
WATCH_NOW Xem ngay bây giờ.

DemandGenImageAd

Thông tin chi tiết về quảng cáo dạng hình ảnh trong chiến dịch Tạo nhu cầu.

Biểu diễn dưới dạng JSON 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": string,
  "headlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "customParameters": {
    string: string,
    ...
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string,
  "marketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "logoImages": [
    {
      object (ImageAsset)
    }
  ]
}
Trường
finalUrl

string

Bắt buộc. Địa chỉ URL của trang web mà mọi người sẽ được chuyển đến sau khi nhấp vào quảng cáo.
trackingUrl

string

Chỉ có đầu ra. Địa chỉ URL được tải trong nền cho mục đích theo dõi.
userSpecifiedTrackingUrl

string

Không bắt buộc. URL theo dõi do người dùng chỉ định theo cách thủ công.
callToAction

string

Bắt buộc. Nút kêu gọi hành động xuất hiện trên quảng cáo.
headlines[]

string

Bắt buộc. Danh sách dòng tiêu đề xuất hiện trên quảng cáo.
descriptions[]

string

Bắt buộc. Danh sách nội dung mô tả xuất hiện trên quảng cáo.
customParameters

map (key: string, value: string)

Không bắt buộc. Các tham số tuỳ chỉnh và giá trị đi kèm để thêm vào URL theo dõi.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
finalMobileUrl

string

Không bắt buộc. Địa chỉ URL của trang web mà mọi người sẽ được chuyển đến sau khi nhấp vào quảng cáo trên thiết bị di động.
finalUrlSuffix

string

Không bắt buộc. Hậu tố cần thêm vào URL trang đích.
businessName

string

Không bắt buộc. Tên doanh nghiệp xuất hiện trên quảng cáo.

Bạn phải đặt chế độ cài đặt này, trừ phi đã đặt giá trị mặc định ở cấp nhà quảng cáo. Nếu bạn không đặt, giá trị mặc định sẽ được áp dụng.
marketingImages[]

object (ImageAsset)

Danh sách hình ảnh tiếp thị xuất hiện trên quảng cáo.
squareMarketingImages[]

object (ImageAsset)

Danh sách hình ảnh tiếp thị vuông xuất hiện trên quảng cáo.
portraitMarketingImages[]

object (ImageAsset)

Danh sách hình ảnh tiếp thị dọc xuất hiện trên quảng cáo.
logoImages[]

object (ImageAsset)

Danh sách hình ảnh biểu trưng xuất hiện trên quảng cáo.

Bạn phải đặt chế độ cài đặt này, trừ phi đã đặt giá trị mặc định ở cấp nhà quảng cáo. Nếu bạn không đặt, giá trị mặc định sẽ được áp dụng.

DemandGenCarouselAd

Thông tin chi tiết về quảng cáo Tạo nhu cầu dạng băng chuyền.

Biểu diễn dưới dạng JSON 
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "cards": [
    {
      object (CarouselCard)
    }
  ],
  "finalUrlSuffix": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  }
}
Trường
finalUrl

string

Bắt buộc. Địa chỉ URL của trang web mà mọi người sẽ được chuyển đến sau khi nhấp vào quảng cáo.
headline

string

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

string

Bắt buộc. Nội dung mô tả của quảng cáo.
cards[]

object (CarouselCard)

Bắt buộc. Danh sách thẻ xuất hiện trên quảng cáo.
finalUrlSuffix

string

Không bắt buộc. Hậu tố cần thêm vào URL trang đích.
trackingUrl

string

Chỉ có đầu ra. Địa chỉ URL được tải trong nền cho mục đích theo dõi.
userSpecifiedTrackingUrl

string

Không bắt buộc. URL theo dõi do người dùng chỉ định theo cách thủ công.
businessName

string

Không bắt buộc. Tên doanh nghiệp xuất hiện trên quảng cáo.

Bạn phải đặt chế độ cài đặt này, trừ phi đã đặt giá trị mặc định ở cấp nhà quảng cáo. Nếu bạn không đặt, giá trị mặc định sẽ được áp dụng.
customParameters

map (key: string, value: string)

Không bắt buộc. Các tham số tuỳ chỉnh và giá trị đi kèm để thêm vào URL theo dõi.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

CarouselCard

Thông tin chi tiết về thẻ băng chuyền của chiến dịch Tạo nhu cầu.

Biểu diễn dưới dạng JSON 
{
  "finalUrl": string,
  "finalMobileUrl": string,
  "headline": string,
  "callToAction": string,
  "marketingImage": {
    object (ImageAsset)
  },
  "squareMarketingImage": {
    object (ImageAsset)
  },
  "portraitMarketingImage": {
    object (ImageAsset)
  }
}
Trường
finalUrl

string

Bắt buộc. Địa chỉ URL của trang web mà mọi người sẽ được chuyển đến sau khi nhấp vào thẻ.
finalMobileUrl

string

Không bắt buộc. Địa chỉ URL của trang web mà mọi người sẽ được chuyển đến sau khi nhấp vào thẻ trên thiết bị di động.
headline

string

Bắt buộc. Dòng tiêu đề của thẻ.
callToAction

string

Bắt buộc. Văn bản trên nút kêu gọi hành động xuất hiện trên thẻ.

Chỉ được dùng tối đa 10 ký tự.
marketingImage

object (ImageAsset)

Không bắt buộc. Hình ảnh tiếp thị xuất hiện trên thẻ.
squareMarketingImage

object (ImageAsset)

Không bắt buộc. Hình ảnh tiếp thị hình vuông xuất hiện trên thẻ.
portraitMarketingImage

object (ImageAsset)

Không bắt buộc. Hình ảnh tiếp thị dọc xuất hiện trên thẻ.

DemandGenProductAd

Thông tin chi tiết về quảng cáo Tạo nhu cầu cho sản phẩm.

Biểu diễn dưới dạng JSON 
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "finalUrlSuffix": string,
  "callToAction": enum (CallToAction),
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  },
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string
}
Trường
finalUrl

string

Bắt buộc. Địa chỉ URL của trang web mà mọi người sẽ được chuyển đến sau khi nhấp vào quảng cáo.
headline

string

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

string

Bắt buộc. Nội dung mô tả của quảng cáo.
finalUrlSuffix

string

Không bắt buộc. Hậu tố cần thêm vào URL trang đích.
callToAction

enum (CallToAction)

Bắt buộc. Nút kêu gọi hành động xuất hiện trên quảng cáo.

Sau đây là các giá trị được hỗ trợ:

  • AUTOMATED
  • APPLY_NOW
  • BOOK_NOW
  • CONTACT_US
  • DOWNLOAD
  • GET_QUOTE
  • LEARN_MORE
  • SHOP_NOW
  • SIGN_UP
  • SUBSCRIBE
trackingUrl

string

Chỉ có đầu ra. Địa chỉ URL được tải trong nền cho mục đích theo dõi.
userSpecifiedTrackingUrl

string

Không bắt buộc. URL theo dõi do người dùng chỉ định theo cách thủ công.
businessName

string

Không bắt buộc. Tên doanh nghiệp xuất hiện trên quảng cáo.

Bạn phải đặt chế độ cài đặt này, trừ phi đã đặt giá trị mặc định ở cấp nhà quảng cáo. Nếu bạn không đặt, giá trị mặc định sẽ được áp dụng.
customParameters

map (key: string, value: string)

Không bắt buộc. Các tham số tuỳ chỉnh và giá trị đi kèm để thêm vào URL theo dõi.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
displayUrlBreadcrumb1

string

Không bắt buộc. Phần đầu tiên sau miền trong URL hiển thị.
displayUrlBreadcrumb2

string

Không bắt buộc. Phần thứ hai sau miền trong URL hiển thị.

AdPolicy

Một chính sách quảng cáo liên kết với một quảng cáo trong nhóm quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "adPolicyApprovalStatus": enum (AdPolicyApprovalStatus),
  "adPolicyReviewStatus": enum (AdPolicyReviewStatus),
  "adPolicyTopicEntry": [
    {
      object (AdPolicyTopicEntry)
    }
  ]
}
Trường
adPolicyApprovalStatus

enum (AdPolicyApprovalStatus)

Trạng thái phê duyệt chính sách của một quảng cáo, cho biết quyết định phê duyệt.
adPolicyReviewStatus

enum (AdPolicyReviewStatus)

Trạng thái đánh giá việc tuân thủ chính sách của một quảng cáo, cho biết quảng cáo hiện đang ở giai đoạn nào trong quy trình xem xét.
adPolicyTopicEntry[]

object (AdPolicyTopicEntry)

Mục nhập cho từng chủ đề chính sách được xác định là có liên quan đến quảng cáo. Mỗi mục bao gồm chủ đề, mức độ hạn chế và hướng dẫn về cách khắc phục các vấn đề về chính sách.

AdPolicyApprovalStatus

Các trạng thái có thể có của một quyết định phê duyệt theo chính sách quảng cáo.

Enum
AD_POLICY_APPROVAL_STATUS_UNKNOWN Không xác định hoặc không được chỉ định.
DISAPPROVED Sẽ không phân phát.
APPROVED_LIMITED Sẽ phân phát nhưng có giới hạn.
APPROVED Sẽ phân phát mà không bị 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 thông tin về các quốc gia được nhắm đến.

AdPolicyReviewStatus

Các trạng thái có thể có của quy trình đánh giá việc tuân thủ chính sách quảng cáo.

Enum
AD_POLICY_REVIEW_STATUS_UNKNOWN Không xác định hoặc không được chỉ định.
REVIEW_IN_PROGRESS Hiện đang được xem xét.
REVIEWED Đã hoàn tất quy trình xem xét chính. Các quy trình xem xét khác có thể vẫn đang diễn ra.
UNDER_APPEAL Đã gửi lại để phê duyệt hoặc đã kháng nghị một quyết định dựa trên chính sách.
ELIGIBLE_MAY_SERVE Được coi là đủ điều kiện và có thể đang phân phát. Chúng tôi vẫn có thể xem xét thêm.

AdPolicyTopicEntry

Một mục mô tả cách một quảng cáo được xác định là có liên quan đến một chính sách quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "policyTopic": string,
  "policyLabel": string,
  "policyTopicDescription": string,
  "policyTopicType": enum (AdPolicyTopicEntryType),
  "policyDecisionType": enum (AdPolicyDecisionType),
  "policyEnforcementMeans": enum (AdPolicyEnforcementMeans),
  "policyTopicEvidences": [
    {
      object (AdPolicyTopicEvidence)
    }
  ],
  "policyTopicConstraints": [
    {
      object (AdPolicyTopicConstraint)
    }
  ],
  "helpCenterLink": string,
  "appealInfo": {
    object (AdPolicyTopicAppealInfo)
  }
}
Trường
policyTopic

string

Chủ đề chính sách.

Ví dụ: "NHÃN HIỆU", "ĐỒ UỐNG CÓ CỒN", v.v.
policyLabel

string

Văn bản nhãn đã bản địa hoá cho chính sách.

Ví dụ: "Nhãn hiệu trong văn bản", "Có chứa đồ uống có cồn", v.v.
policyTopicDescription

string

Nội dung mô tả tóm tắt ngắn gọn về chủ đề chính sách.
policyTopicType

enum (AdPolicyTopicEntryType)

Mức độ ảnh hưởng đến việc phân phát quảng cáo do liên quan đến chủ đề chính sách quảng cáo.
policyDecisionType

enum (AdPolicyDecisionType)

Nguồn của quyết định dựa trên chính sách.
policyEnforcementMeans

enum (AdPolicyEnforcementMeans)

Biện pháp thực thi chính sách được dùng trong quy trình đánh giá việc tuân thủ chính sách.
policyTopicEvidences[]

object (AdPolicyTopicEvidence)

Bằng chứng được dùng trong quyết định dựa trên chính sách.
policyTopicConstraints[]

object (AdPolicyTopicConstraint)

Các quy định hạn chế phân phát có liên quan đến quyết định dựa trên chính sách.
appealInfo

object (AdPolicyTopicAppealInfo)

Thông tin về cách kháng nghị quyết định dựa trên chính sách.

AdPolicyTopicEntryType

Tác động có thể xảy ra đối với việc phân phát của một chủ đề chính sách quảng cáo.

Enum
AD_POLICY_TOPIC_ENTRY_TYPE_UNKNOWN Không xác định hoặc không được chỉ định.
PROHIBITED Tài nguyên sẽ không phân phát.
FULLY_LIMITED Tài nguyên này sẽ không phân phát ở tất cả quốc gia được nhắm đến.
LIMITED Tài nguyên này không thể phân phát ở một số quốc gia.
DESCRIPTIVE Tài nguyên có thể phân phát.
BROADENING Tài nguyên có thể phân phát và có thể phân phát ngoài phạm vi thông thường.
AREA_OF_INTEREST_ONLY Tài nguyên này bị hạn chế ở tất 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 thông tin về các quốc gia được nhắm đến.

AdPolicyDecisionType

Các nguồn có thể đưa ra quyết định dựa trên chính sách.

Enum
AD_POLICY_DECISION_TYPE_UNKNOWN Không xác định hoặc không được chỉ định.
PURSUANT_TO_NOTICE Quyết định này được đưa ra dựa trên một thông báo pháp lý, lệnh toà hoặc đơn khiếu nại của chủ sở hữu nội dung nhãn hiệu, v.v.
GOOGLE_INVESTIGATION Quyết định này là kết quả của một cuộc điều tra do Google thực hiện.

AdPolicyEnforcementMeans

Các biện pháp thực thi chính sách có thể được áp dụng trong quá trình đánh giá việc tuân thủ chính sách.

Enum
AD_POLICY_ENFORCEMENT_MEANS_UNKNOWN Không xác định hoặc không được chỉ định.
AUTOMATED Quy trình thực thi hoàn toàn tự động.
HUMAN_REVIEW Con người đã tham gia một phần hoặc toàn bộ vào quy trình thực thi quyết định.

AdPolicyTopicEvidence

Thông tin bằng chứng được dùng trong quyết định dựa trên chính sách.

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "textList": {
    object (TextList)
  },
  "websiteList": {
    object (WebsiteList)
  },
  "httpCode": integer,
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  },
  "trademark": {
    object (Trademark)
  },
  "legalRemoval": {
    object (LegalRemoval)
  },
  "counterfeit": {
    object (Counterfeit)
  },
  "regionalRequirements": {
    object (RegionalRequirements)
  }
  // End of mutually exclusive fields.
}
Trường
Bằng chứng cho quyết định dựa trên chính sách. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
textList

object (TextList)

Danh sách bằng chứng tìm thấy trong văn bản của quảng cáo.
websiteList

object (WebsiteList)

Danh sách các trang web được liên kết với quảng cáo.
httpCode

integer

Mã HTTP được trả về khi URL cuối cùng được thu thập dữ liệu.
languageCode

string

Ngôn ngữ mà hệ thống phát hiện được trong quảng cáo.

Trường này sử dụng thẻ ngôn ngữ IETF, chẳng hạn như "vi-VN".
destinationTextList

object (DestinationTextList)

Văn bản trong đích đến của quảng cáo gây ra lỗi vi phạm chính sách.
destinationMismatch

object (DestinationMismatch)

URL đích đến của quảng cáo không khớp.
destinationNotWorking

object (DestinationNotWorking)

Thông tin về lỗi HTTP hoặc DNS liên quan đến đích đến của quảng cáo.
trademark

object (Trademark)

Các cụm từ nhãn hiệu gây ra lỗi vi phạm chính sách.
legalRemoval

object (LegalRemoval)

Việc thực thi quy định liên quan đến pháp lý gây ra lỗi vi phạm chính sách.
counterfeit

object (Counterfeit)

Biện pháp thực thi đối với hàng giả gây ra lỗi vi phạm chính sách.
regionalRequirements

object (RegionalRequirements)

Biện pháp thực thi chủ động của nhóm Tin cậy và An toàn dẫn đến lỗi vi phạm chính sách.
Kết thúc các trường loại trừ lẫn nhau.

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 gây ra kết quả vi phạm chính sách.

WebsiteList

Danh sách các trang web vi phạm chính sách.

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

string

Các trang web gây ra lỗi vi phạm chính sách.

DestinationTextList

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

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

string

Văn bản đích gây ra lỗi vi phạm chính sách.

DestinationMismatch

Thông tin chi tiết về trường hợp không khớp giữa các loại URL đích.

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

enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)

Tập hợp các URL không khớp. Danh sách này có thể bao gồm một hoặc nhiều loại URI.

Ví dụ 1: [DISPLAY_URL, FINAL_URL] có nghĩa là URL hiển thị của quảng cáo không khớp với URL cuối cùng của quảng cáo.

Ví dụ 2: [FINAL_URL] có nghĩa là URL cuối cùng của quảng cáo không khớp với URL thu thập dữ liệu, đây cũng được coi là trường hợp đích đến không khớp.

AdPolicyTopicEvidenceDestinationMismatchUrlType

Các loại URL có thể có.

Enum
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_MISMATCH_URL_TYPE_UNKNOWN Không được chỉ định hoặc không xác định.
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 URL theo dõi.
MOBILE_TRACKING_URL URL theo dõi dành cho thiết bị di động.

DestinationNotWorking

Thông tin chi tiết về lỗi HTTP hoặc DNS liên quan đến đích đến của quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "expandedUri": string,
  "device": enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType),
  "lastCheckedTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dnsErrorType": enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of mutually exclusive fields.
}
Trường
expandedUri

string

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

enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)

Thiết bị truy cập vào URL dẫn đến lỗi.
lastCheckedTime

string (Timestamp format)

Lần gần đây nhất xảy ra lỗi khi chuyển đến URL.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
Lỗi HTTP hoặc DNS. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
dnsErrorType

enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

Loại lỗi DNS.
httpErrorCode

string (int64 format)

Mã lỗi HTTP.
Kết thúc các trường loại trừ lẫn nhau.

AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType

Các loại lỗi DNS có thể xảy ra.

Enum
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DNS_ERROR_TYPE_UNKNOWN Không được chỉ định hoặc không xác định.
HOSTNAME_NOT_FOUND Không tìm thấy tên máy chủ lưu trữ trong DNS khi tìm nạp trang đích.
GOOGLE_CRAWLER_DNS_ISSUE Google không thể thu thập dữ liệu trên trang đích khi giao tiếp với DNS.

AdPolicyTopicEvidenceDestinationNotWorkingDeviceType

Những thiết bị có thể đã gặp lỗi khi truy cập vào URL.

Enum
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DEVICE_TYPE_UNKNOWN Không được chỉ định hoặc không xác định.
DESKTOP Máy tính.
ANDROID Thiết bị Android.
IOS Thiết bị iOS.

Nhãn hiệu

Các cụm từ nhãn hiệu gây ra lỗi vi phạm chính sách.

Biểu diễn dưới dạng JSON 
{
  "owner": string,
  "term": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Trường
owner

string

Chủ sở hữu nội dung nhãn hiệu.
term

string

Cụm từ nhãn hiệu.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Các quốc gia có liên quan đến lỗi vi phạm chính sách.

AdPolicyCriterionRestriction

Đại diện cho một quy định hạn chế theo quốc gia.

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

string (int64 format)

Mã tiêu chí quốc gia.
countryLabel

string

Tên đã bản địa hoá của quốc gia. Có thể để trống.

LegalRemoval

Thực thi quy định liên quan đến pháp lý, theo DMCA hoặc quy định pháp lý của địa phương.

Biểu diễn dưới dạng JSON 
{
  "complaintType": enum (AdPolicyTopicEvidenceLegalRemovalComplaintType),
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ],
  "restrictedUris": [
    string
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of mutually exclusive fields.
}
Trường
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

Loại đơn khiếu kiện dẫn đến việc gỡ bỏ vì lý do pháp lý.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Những quốc gia bị hạn chế do yêu cầu gỡ bỏ vì lý do pháp lý.
restrictedUris[]

string

Các URL bị hạn chế do yêu cầu gỡ bỏ vì lý do pháp lý.
Thông tin chi tiết về loại yêu cầu gỡ bỏ vì lý do pháp lý. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
dmca

object (Dmca)

Thông tin chi tiết về việc gỡ bỏ vì lý do pháp lý theo quy định của DMCA.
Kết thúc các trường loại trừ lẫn nhau.

Dmca

Thông tin chi tiết về đơn kiện theo DMCA.

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

string

Pháp nhân đã gửi đơn kiện pháp lý.

LocalLegal

Thông tin chi tiết về quy định pháp lý tại địa phương.

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

string

Loại luật cho thông báo pháp lý.

AdPolicyTopicEvidenceLegalRemovalComplaintType

Các loại đơn khiếu kiện có thể có để gỡ bỏ vì lý do pháp lý.

Enum
COPYRIGHT

Bản quyền.

Chỉ áp dụng cho DMCA.
COURT_ORDER

Lệnh toà.

Chỉ áp dụng cho pháp lý địa phương.

Hàng giả

Thông tin chi tiết về biện pháp thực thi đối với hàng giả dẫn đến lỗi vi phạm chính sách.

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

string

Chủ sở hữu nội dung hoặc sản phẩm đã khiếu kiện.

RegionalRequirements

Nhóm Tin cậy và An toàn (T&S) chủ động thực thi các chính sách nhằm giải quyết các yêu cầu theo khu vực. Đây được coi là một cuộc điều tra do Google thực hiện thay vì thông báo quy định vì đây là biện pháp thực thi chủ động của Nhóm Tin cậy và An toàn.

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

object (RegionalRequirementsEntry)

Danh sách các yêu cầu theo khu vực.

RegionalRequirementsEntry

Thông tin chi tiết về lỗi vi phạm pháp lý theo khu vực ở cấp chính sách.

Biểu diễn dưới dạng JSON 
{
  "legalPolicy": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Trường
legalPolicy

string

Chính sách pháp lý bị vi phạm.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Các quốc gia bị hạn chế do chính sách pháp lý.

AdPolicyTopicConstraint

Thông tin chi tiết về các quy định hạn chế đối với việc phân phát quảng cáo.

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of mutually exclusive fields.
}
Trường
Quy tắc ràng buộc về việc phân phát. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
countryConstraint

object (AdPolicyCountryConstraintList)

Những quốc gia không thể phân phát quảng cáo.
resellerConstraint

object (AdPolicyResellerConstraint)

Quy định ràng buộc của đại lý.
certificateMissingCountryList

object (AdPolicyCountryConstraintList)

Những quốc gia yêu cầu phải có giấy chứng nhận để phân phát quảng cáo.
certificateDomainMismatchCountryList

object (AdPolicyCountryConstraintList)

Những quốc gia mà miền của tài nguyên không được chứng chỉ liên kết với tài nguyên đó bao gồm.
globalCertificateMissing

object (AdPolicyGlobalCertificateMissingConstraint)

Bạn phải có giấy chứng nhận để phân phát quảng cáo ở bất kỳ quốc gia nào.
globalCertificateDomainMismatch

object (AdPolicyGlobalCertificateDomainMismatchConstraint)

Bạn cần có giấy chứng nhận để phân phát quảng cáo ở bất kỳ quốc gia nào và giấy chứng nhận hiện tại không áp dụng cho miền của quảng cáo.
Kết thúc các trường loại trừ lẫn nhau.

AdPolicyCountryConstraintList

Danh sách các quốc gia nơi quảng cáo không thể phân phát do các quy định ràng buộc của chính sách.

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

object (AdPolicyCriterionRestriction)

Những quốc gia không thể phân phát quảng cáo.

AdPolicyResellerConstraint

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

Chủ đề chính sách bị hạn chế do trang web bị từ chối vì mục đích của đại lý.

AdPolicyGlobalCertificateMissingConstraint

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

Bạn phải có giấy chứng nhận để phân phát quảng cáo ở bất kỳ quốc gia nào.

AdPolicyGlobalCertificateDomainMismatchConstraint

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

Bạn cần có giấy chứng nhận để phân phát quảng cáo ở bất kỳ quốc gia nào và giấy chứng nhận hiện tại không áp dụng cho miền của quảng cáo.

AdPolicyTopicAppealInfo

Thông tin về cách kháng nghị quyết định dựa trên chính sách.

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

enum (AdPolicyAppealType)

Liệu bạn có thể kháng nghị quyết định này thông qua quy trình tự kháng nghị hay biểu mẫu kháng nghị hay không.

AdPolicyAppealType

Các loại đơn kháng nghị có thể có.

Enum
AD_POLICY_APPEAL_TYPE_UNKNOWN Không xác định hoặc không được chỉ định.
SELF_SERVICE_APPEAL Bạn có thể kháng nghị quyết định này thông qua quy trình tự kháng nghị.
APPEAL_FORM Bạn có thể kháng nghị quyết định này bằng biểu mẫu kháng nghị.

AdUrl

Các URL khác liên quan đến quảng cáo, bao gồm cả đèn hiệu.

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

enum (AdUrlType)

Loại URL quảng cáo.
url

string

Giá trị chuỗi URL.

AdUrlType

Các loại URL quảng cáo có thể có.

Enum
AD_URL_TYPE_UNSPECIFIED Không xác định hoặc không được chỉ định.
AD_URL_TYPE_BEACON_IMPRESSION Một pixel theo dõi 1x1 để ping khi một lượt hiển thị của mẫu quảng cáo được phân phối.
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION Đèn hiệu hiển thị DCM có thể mở rộng. Tại thời điểm phân phát, tệp này được mở rộng thành nhiều beacon.
AD_URL_TYPE_BEACON_CLICK URL theo dõi để ping khi sự kiện nhấp chuột được kích hoạt.
AD_URL_TYPE_BEACON_SKIP URL theo dõi để ping khi sự kiện bỏ qua được kích hoạt.

DcmTrackingInfo

Thông tin chi tiết về tính năng theo dõi DCM.

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

string (int64 format)

Bắt buộc. Mã vị trí DCM.
trackingAdId

string (int64 format)

Bắt buộc. Mã quảng cáo được theo dõi DCM.
creativeId

string (int64 format)

Bắt buộc. Mã mẫu quảng cáo DCM.

Phương thức

create

 Tạo quảng cáo trong nhóm quảng cáo.

delete

 Xoá quảng cáo trong nhóm quảng cáo.

get

 Lấy quảng cáo trong nhóm quảng cáo.

list

 Liệt kê quảng cáo trong nhóm quảng cáo.

patch

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