REST Resource: advertisers.adGroupAds

Tài nguyên: AdGroupAd

Một quảng cáo duy nhất đượ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)
    }
  ],

  // Union field ad_details can be only one of the following:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  }
  // End of list of possible types for union field ad_details.
}
Trường
name

string

Tên tài nguyên của quảng cáo.
advertiserId

string (int64 format)

Mã nhận dạng duy nhất của nhà quảng cáo mà quảng cáo thuộc về.
adGroupAdId

string (int64 format)

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

string (int64 format)

Mã nhận dạng riêng biệt của nhóm quảng cáo chứa quảng cáo.
displayName

string

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)

Trạng thái phê duyệt chính sách của quảng cáo.
entityStatus

enum (EntityStatus)

Trạng thái thực thể của quảng cáo.
adUrls[]

object (AdUrl)

Danh sách URL mà quảng cáo sử dụng.

Trường nhóm ad_details. Thông tin chi tiết về quảng cáo.

ad_details chỉ có thể là một trong những trạng thái sau:
displayVideoSourceAd

object (DisplayVideoSourceAd)

Thông tin chi tiết về một quảng cáo lấy từ mẫu quảng cáo trên Display & Video 360.
mastheadAd

object (MastheadAd)

Thông tin chi tiết về một 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)

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

object (NonSkippableAd)

Thông tin chi tiết về quảng cáo dạng video ngắn 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 mục tiêu tiếp thị phạm vi tiếp cận.
bumperAd

object (BumperAd)

Thông tin chi tiết về một 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, được dùng để tăng phạm vi tiếp cận.
audioAd

object (AudioAd)

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

object (VideoDiscoveryAd)

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

object (VideoPerformanceAd)

Thông tin chi tiết về một 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.

AdPolicy

Một chính sách quảng cáo duy nhất được liên kết với 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 ở bước nào trong quy trình đánh giá.
adPolicyTopicEntry[]

object (AdPolicyTopicEntry)

Các mục 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 nhập đều có 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 quảng cáo được phê duyệt theo chính sách.

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ó hạn chế.
APPROVED Sẽ phân phát mà không bị hạn chế.
AREA_OF_INTEREST_ONLY 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.

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 về 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 xác định rằng một quảng cáo 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ụ: "THƯƠNG HIỆU", "ĐỒ UỐNG CÓ CỒN", v.v.
policyLabel

string

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

Ví dụ: "Nhãn hiệu trong văn bản", "Chứa 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 của việc phân phát quảng cáo do có liên quan đến chủ đề chính sách quảng cáo.
policyDecisionType

enum (AdPolicyDecisionType)

Nguồn của quyết định về chính sách.
policyEnforcementMeans

enum (AdPolicyEnforcementMeans)

Phương thức thực thi chính sách được dùng trong quy trình đánh giá chính sách.
policyTopicEvidences[]

object (AdPolicyTopicEvidence)

Bằng chứng được dùng trong quyết định về chính sách.
policyTopicConstraints[]

object (AdPolicyTopicConstraint)

Các điều kiện hạn chế phân phát có liên quan đến quyết định về chính sách.
appealInfo

object (AdPolicyTopicAppealInfo)

Thông tin về cách kháng nghị quyết định liên quan đến chính sách.

AdPolicyTopicEntryType

Những tác động có thể xảy ra đối với việc phân phát của một chủ đề về 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 sẽ không phân phát ở tất cả các quốc gia mục tiêu.
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 này có thể phục vụ và có thể phục vụ ngoài phạm vi phủ sóng thông thường.
AREA_OF_INTEREST_ONLY Tài nguyên này bị hạn chế ở tất cả các quốc gia mục tiêu, 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 mục tiêu.

AdPolicyDecisionType

Các nguồn có thể có của một quyết định về 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 xuất phát từ thông báo pháp lý, lệnh toà hoặc đơn khiếu kiện của chủ sở hữu nhãn hiệu nội dung, 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 sử dụng trong quá trình xem xét 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 diễn ra hoàn toàn tự động.
HUMAN_REVIEW Có 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 về chính sách.

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

  // Union field value can be only one of the following:
  "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 list of possible types for union field value.
}
Trường
Trường nhóm value. Bằng chứng cho quyết định về chính sách. value chỉ có thể là một trong những trạng thái sau:
textList

object (TextList)

Danh sách bằng chứng được 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 thấy được dùng để viết quảng cáo.

Trường này sử dụng thẻ ngôn ngữ IETF, chẳng hạn như "en-US".
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 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)

Những cụm từ liên quan đến 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ý dẫn đến lỗi vi phạm chính sách.
counterfeit

object (Counterfeit)

Việc thực thi chính sách về hàng giả dẫn đến 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 Điều khoản và điều kiện dẫn đến lỗi vi phạm 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

Đoạn văn bản trong tài nguyên gây ra sự phát hiện về 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

Những trang web khiến bạn bị phát hiện 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 sự phát hiện về 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] 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] nghĩa là URL cuối cùng của quảng cáo không khớp với URL được thu thập thông tin, điều này cũng được coi là trang đích 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 trên 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,

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

string

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

enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)

Thiết bị mà khi truy cập vào URL này đã xảy ra lỗi.
lastCheckedTime

string (Timestamp format)

Lần gần đây nhất lỗi xuất hiện 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".
Trường nhóm reason. Lỗi HTTP hoặc DNS. reason chỉ có thể là một trong những trạng thái sau:
dnsErrorType

enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

Loại lỗi DNS.
httpErrorCode

string (int64 format)

Mã lỗi HTTP.

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 thu thập dữ liệu được trên trang đích khi giao tiếp với DNS.

AdPolicyTopicEvidenceDestinationNotWorkingDeviceType

Các 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 Thiết bị máy tính.
ANDROID Thiết bị Android.
IOS Thiết bị iOS.

Nhãn hiệu

Những cụm từ liên quan đến 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)

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

AdPolicyCriterionRestriction

Đại diện cho một chế độ 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 Đạo luật bản quyền kỹ thuật số thiên niên kỷ (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
  ],

  // Union field type can be only one of the following:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of list of possible types for union field type.
}
Trường
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

Loại đơn khiếu kiện gây ra yêu cầu gỡ bỏ vì lý do pháp lý.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Các 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ý.
Trường nhóm type. Thông tin chi tiết về loại yêu cầu gỡ bỏ vì lý do pháp lý. type chỉ có thể là một trong những trạng thái sau:
dmca

object (Dmca)

Thông tin chi tiết về yêu cầu gỡ bỏ nội dung vì lý do pháp lý theo quy định của Đạo luật bản quyền kỹ thuật số thiên niên kỷ (DMCA).

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 luật tại địa phương.

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

string

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

AdPolicyTopicEvidenceLegalRemovalComplaintType

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

Enum
COPYRIGHT

Bản quyền.

Chỉ áp dụng cho Đạo luật bản quyền thiên niên kỷ kỹ thuật số (DMCA).
COURT_ORDER

Lệnh toà.

Chỉ áp dụng cho luật pháp địa phương.

Hàng giả

Thông tin chi tiết về việc 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 đã gửi đơn kiện.

RegionalRequirements

Hoạt động thực thi chủ động của nhóm Tin cậy và An toàn (T&S) đối với các chính sách nhằm đáp ứng các yêu cầu theo khu vực. Đây được coi là một cuộc điều tra của Google thay vì thông báo về quy định vì đây là hoạt động thực thi Điều khoản và điều kiện chủ động.

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 luật 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 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,

  // Union field constraint can be only one of the following:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of list of possible types for union field constraint.
}
Trường
Trường nhóm constraint. Ràng buộc phân phát. constraint chỉ có thể là một trong những trạng thái sau:
countryConstraint

object (AdPolicyCountryConstraintList)

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

object (AdPolicyResellerConstraint)

Hạn chế đối với đại lý.
certificateMissingCountryList

object (AdPolicyCountryConstraintList)

Quốc gia mà bạn phải có chứng chỉ để phân phát.
certificateDomainMismatchCountryList

object (AdPolicyCountryConstraintList)

Những quốc gia mà miền của tài nguyên không thuộc phạm vi của các chứng chỉ được liên kết với tài nguyên đó.
globalCertificateMissing

object (AdPolicyGlobalCertificateMissingConstraint)

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

object (AdPolicyGlobalCertificateDomainMismatchConstraint)

Bạn phải có chứng chỉ để phân phát quảng cáo ở bất kỳ quốc gia nào và chứng chỉ hiện có không bao gồm miền của quảng cáo.

AdPolicyCountryConstraintList

Danh sách các quốc gia mà quảng cáo không thể phân phát do các hạn chế về 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 mà quảng cáo không thể phân phát.

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 bán lại.

AdPolicyGlobalCertificateMissingConstraint

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

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

AdPolicyGlobalCertificateDomainMismatchConstraint

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

Bạn phải có chứng chỉ để phân phát quảng cáo ở bất kỳ quốc gia nào và chứng chỉ hiện có không bao gồm 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 thông qua biểu mẫu kháng nghị tự phục vụ 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 tính năng 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ị.

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ã nhận dạng 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 tự động phát trên YouTube trong Video nổi bật trên trang đầu.
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)

Khoảng thời gian 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 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ữ xuất hiện ở đầ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á 2.

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)
}
Trường
id

string

Mã video trên YouTube mà bạn có thể tìm kiếm trên trang web YouTube.
unavailableReason

enum (VideoUnavailableReason)

Lý do không có dữ liệu video.

VideoUnavailableReason

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

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

VideoAspectRatio

Các tỷ lệ khung hình có thể có của một 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.
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)

Thuộc tính quảng cáo chung.
customParameters

map (key: string, value: string)

Tham số tuỳ chỉnh để truyền các giá trị tuỳ chỉnh đến mẫu 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 chung 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,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
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 ở chế độ nền cho mục đích theo dõi.
actionButtonLabel

string

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

string

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

object (YoutubeVideoDetails)

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

object (ImageAsset)

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 một thành phần hình ảnh.

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

string

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

object (Dimensions)

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

string (int64 format)

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

NonSkippableAd

Thông tin chi tiết 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)

Thuộc tính quảng cáo chung.
customParameters

map (key: string, value: string)

Tham số tuỳ chỉnh để truyền các giá trị tuỳ chỉnh đến mẫu 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 chi tiết về quảng cáo đệm.

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

object (CommonInStreamAttribute)

Thuộc tính quảng cáo chung.

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,
  "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 ở chế độ nền cho mục đích theo dõi.
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 của 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 có thể có về hình thu nhỏ trong quảng cáo khám phá dạng video.

Enum
THUMBNAIL_UNSPECIFIED Không xác định hoặc không 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 dạng video nâng cao hiệu suất.

Biểu diễn dưới dạng JSON 
{
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabels": [
    string
  ],
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "domain": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanners": [
    {
      object (ImageAsset)
    }
  ]
}
Trường
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 ở chế độ nền cho mục đích theo dõi.
actionButtonLabels[]

string

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.
headlines[]

string

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

string

Danh sách dòng tiêu đề độc lập xuất hiện trên biểu ngữ kêu gọi hành động.
descriptions[]

string

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.
displayUrlBreadcrumb1

string

Phần đầu tiên sau miền trong URL hiển thị.
displayUrlBreadcrumb2

string

Phần thứ hai sau miền trong URL hiển thị.
domain

string

Miền của URL hiển thị.
videos[]

object (YoutubeVideoDetails)

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)

Tham số tuỳ chỉnh để truyền các giá trị tuỳ chỉnh đến mẫu 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)

Danh sách biểu ngữ đi kèm mà quảng cáo này sử dụng.

AdUrl

Các URL bổ sung liên quan đến quảng cáo, bao gồm cả các beacon.

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 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 Báo hiệu lượt hiển thị DCM có thể mở rộng. Tại thời điểm phân phát, chỉ số này được mở rộng thành một số 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.

Phương thức

get

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

list

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