SearchAds360Row

{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}

string

Tên tài nguyên của nhóm quảng cáo. Tên tài nguyên nhóm quảng cáo có dạng:

customers/{customerId}/adGroups/{ad_group_id}

enum (AdGroupStatus)

Trạng thái của nhóm quảng cáo.

enum (AdGroupType)

Loại nhóm quảng cáo.

enum (AdGroupAdRotationMode)

Chế độ xoay vòng quảng cáo của nhóm quảng cáo.

string

Dấu thời gian khi Nhóm quảng cáo này được tạo. Dấu thời gian được tính theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss" .

object (TargetingSetting)

Chế độ cài đặt cho các tính năng liên quan đến tiêu chí nhắm mục tiêu.

string

Tên tài nguyên của các nhãn được đính kèm với nhóm quảng cáo này.

string

Mã của nhóm quảng cáo trong tài khoản công cụ bên ngoài. Trường này chỉ dành cho tài khoản không phải tài khoản Google Ads, ví dụ: Yahoo Japan, Microsoft, Baidu, v.v. Đối với thực thể Google Ads, hãy sử dụng "adGroup.id" thay thế.

string

Ngày nhóm quảng cáo này bắt đầu phân phát quảng cáo. Theo mặc định, ngày bắt đầu của nhóm quảng cáo hoặc ngày bắt đầu của nhóm quảng cáo, tuỳ vào ngày nào đến sau. Nếu bạn đặt trường này, thì nhóm quảng cáo sẽ bắt đầu vào đầu ngày được chỉ định theo múi giờ của khách hàng. Trường này chỉ dành cho các tài khoản cổng vào Microsoft Advertising và Facebook.

Định dạng: YYYY-MM-DD Ví dụ: 2019-03-14

string

Ngày nhóm quảng cáo kết thúc phân phát quảng cáo. Theo mặc định, nhóm quảng cáo kết thúc vào ngày kết thúc của nhóm quảng cáo. Nếu bạn đặt trường này thì nhóm quảng cáo sẽ kết thúc vào cuối ngày được chỉ định theo múi giờ của khách hàng. Trường này chỉ dành cho các tài khoản cổng vào Microsoft Advertising và Facebook.

Định dạng: YYYY-MM-DD Ví dụ: 2019-03-14

string

Ngôn ngữ của quảng cáo và từ khoá trong nhóm quảng cáo. Trường này chỉ dành cho tài khoản Microsoft Advertising. Thêm chi tiết: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

string

Ngày giờ khi nhóm quảng cáo này được sửa đổi lần cuối. Ngày giờ theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss" .

string (int64 format)

Mã của nhóm quảng cáo.

string

Tên của nhóm quảng cáo.

Trường này là bắt buộc và không được để trống khi tạo nhóm quảng cáo mới.

Mã này phải chứa ít hơn 255 ký tự có độ rộng đầy đủ UTF-8.

Nó không được chứa bất kỳ ký tự rỗng (điểm mã 0x0), nguồn cấp dữ liệu dòng NL (điểm mã 0xA) hoặc ký tự trả lại vị trí đầu dòng (điểm mã 0xD).

string (int64 format)

Giá thầu CPC (chi phí mỗi lượt nhấp) tối đa.

enum (AdGroupEngineStatus)

Trạng thái của công cụ cho nhóm quảng cáo.

{
  "targetRestrictions": [
    {
      object (TargetRestriction)
    }
  ]
}

object (TargetRestriction)

Chế độ cài đặt theo phương diện nhắm mục tiêu để hạn chế phạm vi tiếp cận của chiến dịch hoặc nhóm quảng cáo.

{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}

enum (TargetingDimension)

Phương diện nhắm mục tiêu mà các chế độ cài đặt này áp dụng.

boolean

Cho biết liệu bạn muốn giới hạn để quảng cáo của mình chỉ hiển thị cho các tiêu chí mà bạn đã chọn cho phương diện nhắm mục tiêu này, hay sẽ nhắm mục tiêu tất cả các giá trị cho phương diện nhắm mục tiêu này và hiển thị quảng cáo dựa trên tiêu chí nhắm mục tiêu của bạn trong các phương diện nhắm mục tiêu khác. Giá trị true có nghĩa là các tiêu chí này sẽ chỉ áp dụng hệ số điều chỉnh giá thầu và không ảnh hưởng đến tiêu chí nhắm mục tiêu. Giá trị false có nghĩa là các tiêu chí này sẽ hạn chế việc nhắm mục tiêu cũng như áp dụng hệ số điều chỉnh giá thầu.

{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}

string

Tên tài nguyên của quảng cáo. Tên tài nguyên quảng cáo của nhóm quảng cáo có dạng:

customers/{customerId}/adGroupAds/{ad_group_id}~{adId}

enum (AdGroupAdStatus)

Trạng thái của quảng cáo.

object (Ad)

Quảng cáo.

string

Dấu thời gian khi adGroupAd này được tạo. Ngày giờ theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss" .

string

Tên tài nguyên của các nhãn được đính kèm với quảng cáo trong nhóm quảng cáo này.

string

Mã của quảng cáo trong tài khoản công cụ bên ngoài. Trường này chỉ dành cho tài khoản Search Ads 360, ví dụ: Yahoo Japan, Microsoft, Baidu, v.v. Đối với thực thể không phải Search Ads 360, hãy sử dụng "adGroupAd.ad.id" thay thế.

enum (AdGroupAdEngineStatus)

Trạng thái bổ sung của quảng cáo trong tài khoản công cụ bên ngoài. Các trạng thái có thể có (tuỳ thuộc vào loại tài khoản bên ngoài) bao gồm đang hoạt động, đủ điều kiện, đang chờ xem xét, v.v.

string

Ngày giờ khi quảng cáo của nhóm quảng cáo này được sửa đổi lần cuối. Ngày giờ theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss" .

{
  "resourceName": string,
  "finalUrls": [
    string
  ],
  "type": enum (AdType),
  "id": string,
  "displayUrl": string,
  "name": string,

  // Union field ad_data can be only one of the following:
  "textAd": {
    object (SearchAds360TextAdInfo)
  },
  "expandedTextAd": {
    object (SearchAds360ExpandedTextAdInfo)
  },
  "responsiveSearchAd": {
    object (SearchAds360ResponsiveSearchAdInfo)
  },
  "productAd": {
    object (SearchAds360ProductAdInfo)
  },
  "expandedDynamicSearchAd": {
    object (SearchAds360ExpandedDynamicSearchAdInfo)
  }
  // End of list of possible types for union field ad_data.
}

string

Tên tài nguyên của quảng cáo. Tên tài nguyên quảng cáo có dạng:

customers/{customerId}/ads/{adId}

string

Danh sách URL cuối cùng có thể có sau tất cả các lần chuyển hướng giữa nhiều miền cho quảng cáo.

enum (AdType)

Loại quảng cáo.

string (int64 format)

Mã của quảng cáo.

string

URL xuất hiện trong nội dung mô tả quảng cáo cho một số định dạng quảng cáo.

string

Tên của quảng cáo. Thông tin này chỉ được dùng để xác định quảng cáo. Mã này không cần phải là duy nhất và không ảnh hưởng đến quảng cáo được phân phát. Hiện tại, trường tên chỉ được hỗ trợ cho DisplayUploadAd, ImageAd, ShoppingCompareListingAd và VideoAd.

object (SearchAds360TextAdInfo)

Thông tin chi tiết liên quan đến quảng cáo dạng văn bản.

object (SearchAds360ExpandedTextAdInfo)

Thông tin chi tiết liên quan đến quảng cáo dạng văn bản mở rộng.

object (SearchAds360ResponsiveSearchAdInfo)

Thông tin chi tiết liên quan đến một quảng cáo tìm kiếm thích ứng.

object (SearchAds360ProductAdInfo)

Thông tin chi tiết liên quan đến một quảng cáo sản phẩm.

object (SearchAds360ExpandedDynamicSearchAdInfo)

Thông tin chi tiết liên quan đến một quảng cáo tìm kiếm động mở rộng.

{
  "headline": string,
  "description1": string,
  "description2": string,
  "displayUrl": string,
  "displayMobileUrl": string,
  "adTrackingId": string
}

string

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

string

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

string

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

string

URL hiển thị của quảng cáo.

string

URL được hiển thị trên thiết bị di động của quảng cáo.

string (int64 format)

Mã theo dõi của quảng cáo.

{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}

string

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

string

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

string

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

string

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

string

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

string

Văn bản được thêm vào URL hiển thị được tạo tự động bằng một dấu phân cách.

string

Đã thêm văn bản vào đường dẫn 1 bằng một dấu phân cách.

string (int64 format)

Mã theo dõi của quảng cáo.

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}

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, dòng tiêu đề sẽ được chọn từ danh sách này.

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, nội dung mô tả sẽ được chọn từ danh sách này.

string

Văn bản được thêm vào URL hiển thị được tạo tự động bằng một dấu phân cách.

string

Đã thêm văn bản vào đường dẫn 1 bằng một dấu phân cách.

string (int64 format)

Mã theo dõi của quảng cáo.

{
  "text": string
}

string

Văn bản nội dung.

{
  "description1": string,
  "description2": string,
  "adTrackingId": string
}

string

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

string

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

string (int64 format)

Mã theo dõi của quảng cáo.

{
  "resourceName": string,
  "adGroupAd": string,
  "label": string
}

string

Tên tài nguyên của nhãn quảng cáo trong nhóm quảng cáo. Tên tài nguyên nhãn quảng cáo của nhóm quảng cáo có dạng: customers/{customerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}

string

Quảng cáo trong nhóm quảng cáo mà nhãn được đính kèm.

string

Nhãn được chỉ định cho quảng cáo của nhóm quảng cáo.

{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}

string

Tên tài nguyên của thành phần nhóm quảng cáo. Tên tài nguyên AdGroupAsset có dạng như sau:

customers/{customerId}/adGroupAssets/{ad_group_id}~{assetId}~{fieldType}

string

Bắt buộc. Nhóm quảng cáo mà tài sản được liên kết.

string

Bắt buộc. Thành phần được liên kết với nhóm quảng cáo.

enum (AssetLinkStatus)

Trạng thái của thành phần nhóm quảng cáo.

{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}

string

Tên tài nguyên của nhóm thành phần nhóm quảng cáo. Tên tài nguyên nhóm thành phần của nhóm quảng cáo có dạng như sau:

customers/{customerId}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

string

Nhóm quảng cáo mà tập hợp thành phần này được liên kết.

string

Nhóm thành phần được liên kết với nhóm quảng cáo.

enum (AssetSetLinkStatus)

Trạng thái của nhóm thành phần nhóm quảng cáo. Chỉ có thể đọc.

{
  "resourceName": string
}

string

Tên tài nguyên của chế độ xem đối tượng nhóm quảng cáo. Tên tài nguyên chế độ xem đối tượng của nhóm quảng cáo có dạng:

customers/{customerId}/adGroupAudienceViews/{ad_group_id}~{criterionId}

{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}

string

Tên tài nguyên của hệ số sửa đổi giá thầu cho nhóm quảng cáo. Tên tài nguyên hệ số sửa đổi giá thầu của nhóm quảng cáo có dạng như sau:

customers/{customerId}/adGroupBidModifiers/{ad_group_id}~{criterionId}

number

Công cụ sửa đổi cho giá thầu khi tiêu chí phù hợp. Công cụ sửa đổi phải nằm trong khoảng: 0,1 – 10,0. Phạm vi là từ 1.0 - 6.0 cho PreferredContent. Sử dụng số 0 để chọn không sử dụng một Loại thiết bị.

object (DeviceInfo)

Tiêu chí thiết bị.

{
  "type": enum (Device)
}

enum (Device)

Loại thiết bị.

{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}

string

Tên tài nguyên của tiêu chí nhóm quảng cáo. Tên tài nguyên tiêu chí của nhóm quảng cáo có dạng như sau:

customers/{customerId}/adGroupCriteria/{ad_group_id}~{criterionId}

string

Dấu thời gian khi tiêu chí nhóm quảng cáo này được tạo. Dấu thời gian được tính theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss" .

enum (AdGroupCriterionStatus)

Trạng thái của tiêu chí.

Đây là trạng thái của thực thể tiêu chí nhóm quảng cáo do khách hàng đặt. Lưu ý: Báo cáo giao diện người dùng có thể kết hợp thêm thông tin ảnh hưởng đến việc một tiêu chí có đủ điều kiện chạy hay không. Trong một số trường hợp, một tiêu chí đã bị XOÁ trong API vẫn có thể hiển thị là đã bật trong giao diện người dùng. Ví dụ: các chiến dịch theo mặc định hiển thị cho người dùng thuộc tất cả các độ tuổi trừ khi bị loại trừ. Giao diện người dùng sẽ hiển thị từng độ tuổi là "đã bật", vì người dùng đủ điều kiện xem quảng cáo; nhưng AdGroupCriterion.status sẽ hiển thị "đã xoá", vì không có tiêu chí khẳng định nào được thêm vào.

object (QualityInfo)

Thông tin về chất lượng của tiêu chí.

enum (CriterionType)

Loại tiêu chí.

string

Tên tài nguyên của các nhãn được đính kèm với tiêu chí của nhóm quảng cáo này.

object (PositionEstimates)

Số liệu ước tính cho giá thầu tiêu chí ở các vị trí khác nhau.

string

Danh sách URL cuối cùng có thể có sau tất cả các lần chuyển hướng giữa nhiều miền cho quảng cáo.

string

Mã của tiêu chí nhóm quảng cáo trong tài khoản công cụ bên ngoài. Trường này chỉ dành cho tài khoản không phải tài khoản Google Ads, ví dụ: Yahoo Japan, Microsoft, Baidu, v.v. Đối với thực thể Google Ads, hãy sử dụng "adGroupCriterion.criterion_id" thay thế.

string

Ngày giờ khi tiêu chí của nhóm quảng cáo này được sửa đổi lần cuối. Ngày giờ theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss" .

string (int64 format)

Mã của tiêu chí.

string

Nhóm quảng cáo chứa tiêu chí.

boolean

Liệu sẽ nhắm mục tiêu (false) hay loại trừ (true) tiêu chí.

Trường này là không thể thay đổi. Để chuyển một tiêu chí từ dương sang phủ định, hãy xoá rồi thêm lại tiêu chí đó.

number

Công cụ sửa đổi cho giá thầu khi tiêu chí phù hợp. Công cụ sửa đổi phải nằm trong khoảng: 0,1 – 10,0. Hầu hết các loại tiêu chí có thể nhắm mục tiêu đều hỗ trợ đối tượng sửa đổi.

string (int64 format)

Giá thầu CPC (chi phí mỗi lượt nhấp).

string (int64 format)

Giá thầu CPC (chi phí mỗi lượt nhấp) hiệu dụng.

enum (AdGroupCriterionEngineStatus)

Trạng thái công cụ cho tiêu chí nhóm quảng cáo.

string

Mẫu URL để thêm các tham số vào URL cuối cùng.

string

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

object (KeywordInfo)

Từ khoá.

object (ListingGroupInfo)

Nhóm trang thông tin.

object (AgeRangeInfo)

Độ tuổi.

object (GenderInfo)

Giới tính.

object (UserListInfo)

Danh sách người dùng.

object (WebpageInfo)

Trang web

object (LocationInfo)

Vị trí.

{
  "qualityScore": integer
}

integer

Điểm chất lượng.

Trường này có thể không được điền sẵn nếu Google không có đủ thông tin để xác định giá trị.

{
  "topOfPageCpcMicros": string
}

string (int64 format)

Ước tính giá thầu CPC bắt buộc để quảng cáo được hiển thị ở đầu trang đầu tiên của kết quả tìm kiếm.

{
  "matchType": enum (KeywordMatchType),
  "text": string
}

enum (KeywordMatchType)

Loại đối sánh của từ khóa.

string

Văn bản từ khoá (tối đa 80 ký tự và 10 từ).

{
  "type": enum (ListingGroupType)
}

enum (ListingGroupType)

Loại nhóm trang thông tin.

{
  "type": enum (AgeRangeType)
}

enum (AgeRangeType)

Loại độ tuổi.

{
  "type": enum (GenderType)
}

enum (GenderType)

Loại giới tính.

{
  "userList": string
}

string

Tên tài nguyên Danh sách người dùng.

{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}

object (WebpageConditionInfo)

Các điều kiện, hoặc biểu thức logic, để nhắm mục tiêu trang web. Danh sách các điều kiện nhắm mục tiêu trang web được liên kết với nhau khi được đánh giá để nhắm mục tiêu. Danh sách các điều kiện trống cho biết rằng tất cả các trang trên trang web của chiến dịch đều được nhắm mục tiêu.

Trường này là bắt buộc cho các thao tác CREATE và bị cấm trong các thao tác CẬP NHẬT.

number

Tỷ lệ phần trăm mức độ phù hợp của tiêu chí trang web. Đây là tỷ lệ phần trăm mức độ phù hợp của trang web được tính toán dựa trên mục tiêu trang web, mục tiêu trang web phủ định và từ khoá phủ định trong nhóm quảng cáo và chiến dịch. Ví dụ: khi mức độ phù hợp trả về giá trị là 1, thì tức là mức độ bao phủ đó có mức độ phù hợp 100%. Trường này ở chế độ chỉ đọc.

string

Tên của tiêu chí do thông số này xác định. Giá trị tên sẽ được dùng để xác định, sắp xếp và lọc tiêu chí với loại thông số này.

Trường này là bắt buộc cho các thao tác CREATE và bị cấm trong các thao tác CẬP NHẬT.

{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}

enum (WebpageConditionOperand)

Toán hạng điều kiện nhắm mục tiêu trang web.

enum (WebpageConditionOperator)

Toán tử của điều kiện nhắm mục tiêu trang web.

string

Đối số của điều kiện nhắm mục tiêu trang web.

{
  "geoTargetConstant": string
}

string

Tên tài nguyên của hằng số mục tiêu địa lý.

{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string
}

string

Tên tài nguyên của nhãn tiêu chí nhóm quảng cáo. Tên tài nguyên nhãn tiêu chí của nhóm quảng cáo có dạng: customers/{customerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id}

string

Tiêu chí nhóm quảng cáo mà nhãn được đính kèm.

string

Nhãn được chỉ định cho tiêu chí nhóm quảng cáo.

{
  "resourceName": string,
  "adGroup": string,
  "label": string
}

string

Tên tài nguyên của nhãn nhóm quảng cáo. Tên tài nguyên nhãn nhóm quảng cáo có dạng: customers/{customerId}/adGroupLabels/{ad_group_id}~{label_id}

string

Nhóm quảng cáo mà nhãn được đính kèm.

string

Nhãn được chỉ định cho nhóm quảng cáo.

{
  "resourceName": string
}

string

Tên tài nguyên của chế độ xem độ tuổi. Tên tài nguyên của chế độ xem độ tuổi có dạng như sau:

customers/{customerId}/ageRangeViews/{ad_group_id}~{criterionId}

{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}

string

Tên tài nguyên của tài sản. Tên tài nguyên thành phần có dạng như sau:

customers/{customerId}/assets/{assetId}

enum (AssetType)

Loại nội dung.

string

Danh sách URL cuối cùng có thể có sau tất cả các lần chuyển hướng giữa nhiều miền.

enum (AssetStatus)

Trạng thái của tài sản.

string

Dấu thời gian khi thành phần này được tạo. Dấu thời gian được tính theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss" .

string

Ngày giờ khi thành phần này được sửa đổi lần gần đây nhất. Ngày giờ theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss" .

string (int64 format)

ID của nội dung.

string

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

string

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

enum (AssetEngineStatus)

Trạng thái của công cụ cho một tài sản.

object (YoutubeVideoAsset)

Nội dung video trên YouTube.

object (ImageAsset)

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

object (TextAsset)

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

object (UnifiedCalloutAsset)

Một thành phần chú thích hợp nhất.

object (UnifiedSitelinkAsset)

Thành phần đường liên kết hợp nhất của trang web.

object (UnifiedPageFeedAsset)

Một thành phần nguồn cấp dữ liệu trang hợp nhất.

object (MobileAppAsset)

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

object (UnifiedCallAsset)

Một thành phần cuộc gọi hợp nhất.

object (CallToActionAsset)

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

object (UnifiedLocationAsset)

Một thành phần địa điểm hợp nhất.

{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}

string

Tiêu đề video trên YouTube.

string

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

{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}

enum (MimeType)

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

object (ImageDimension)

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

string (int64 format)

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

{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}

string (int64 format)

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

string (int64 format)

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

string

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

{
  "text": string
}

string

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

{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}

string

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

string

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

string

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

object (AdScheduleInfo)

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

boolean

Liệu có hiển thị thành phần theo múi giờ của người dùng tìm kiếm hay không. Áp dụng cho Microsoft Ads.

{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}

enum (MinuteOfHour)

Số phút sau giờ bắt đầu mà lịch biểu này bắt đầu.

Trường này là bắt buộc cho các thao tác CREATE và bị cấm trong các thao tác CẬP NHẬT.

enum (MinuteOfHour)

Số phút sau giờ kết thúc lịch biểu này. Lịch biểu này không bao gồm phút kết thúc.

Trường này là bắt buộc cho các thao tác CREATE và bị cấm trong các thao tác CẬP NHẬT.

enum (DayOfWeek)

Ngày trong tuần mà lịch biểu sẽ áp dụng.

Trường này là bắt buộc cho các thao tác CREATE và bị cấm trong các thao tác CẬP NHẬT.

integer

Giờ bắt đầu sau 24 giờ. Trường này phải nằm trong khoảng từ 0 đến 23.

Trường này là bắt buộc cho các thao tác CREATE và bị cấm trong các thao tác CẬP NHẬT.

integer

Giờ kết thúc sau 24 giờ; 24 biểu thị cuối ngày. Trường này phải nằm trong khoảng từ 0 đến 24.

Trường này là bắt buộc cho các thao tác CREATE và bị cấm trong các thao tác CẬP NHẬT.

{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}

string

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

string

Dòng đầu tiên trong nội dung mô tả cho đường liên kết của trang web. Nếu được thiết lập, thì độ dài phải nằm trong khoảng từ 1 đến 35 (tính cả 2 giá trị đầu cuối) và cũng phải thiết lập đoạn mô tả 2.

string

Dòng thứ hai trong nội dung mô tả cho đường liên kết của trang web. Nếu được đặt, độ dài phải nằm trong khoảng từ 1 đến 35 (tính cả 2 giá trị đầu cuối) và cũng phải đặt thuộc tính description1.

string

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

string

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

object (AdScheduleInfo)

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

string (int64 format)

Mã nhận dạng được dùng để theo dõi số lượt nhấp cho thành phần đường liên kết của trang web. Đây là ứng dụng Yahoo! trường Nhật Bản.

boolean

Liệu có hiển thị thành phần đường liên kết của trang web theo múi giờ của người dùng tìm kiếm hay không. Áp dụng cho Microsoft Ads.

boolean

Liệu lựa chọn ưu tiên có hiển thị thành phần đường liên kết của trang web trên thiết bị di động hay không. Áp dụng cho Microsoft Ads.

{
  "pageUrl": string,
  "labels": [
    string
  ]
}

string

Trang web mà nhà quảng cáo muốn nhắm mục tiêu.

string

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

{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}

string

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

enum (MobileAppVendor)

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

{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}

string

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

string

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

enum (CallConversionReportingState)

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

string

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

object (AdScheduleInfo)

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

boolean

Liệu cuộc gọi có chỉ hiển thị số điện thoại không có đường liên kết đến trang web hay không. Áp dụng cho Microsoft Ads.

boolean

Liệu cuộc gọi có được bật khi theo dõi cuộc gọi hay không. Áp dụng cho Microsoft Ads.

boolean

Liệu có hiển thị phần mở rộng về cuộc gọi theo múi giờ của người dùng tìm kiếm hay không. Áp dụng cho Microsoft Ads.

string

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

string

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

{
  "callToAction": enum (CallToActionType)
}

enum (CallToActionType)

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

{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}

string

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

object (BusinessProfileLocation)

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

enum (LocationOwnershipType)

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

{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}

string

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

string

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

string (int64 format)

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

{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}

string

Tên tài nguyên của thành phần trong nhóm thành phần. Tên tài nguyên thành phần của nhóm thành phần có dạng:

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}

string

Nhóm thành phần mà thành phần trong nhóm thành phần này đang liên kết.

string

Thành phần mà thành phần trong nhóm thành phần này đang liên kết.

enum (AssetFieldType)

Nội dung mô tả về vị trí của thành phần trong nhóm thành phần. Ví dụ: HEADLINE, YOUTUBE_VIDEO, v.v.

enum (AssetLinkStatus)

Trạng thái của mối liên kết giữa một thành phần và nhóm thành phần.

{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}

string

Tên tài nguyên của tín hiệu nhóm thành phần. Tên tài nguyên tín hiệu của nhóm thành phần có dạng:

customers/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}

string

Nhóm thành phần chứa tín hiệu của nhóm thành phần này.

object (AudienceInfo)

Tín hiệu về đối tượng mà chiến dịch tối đa hoá hiệu suất sẽ sử dụng.

{
  "audience": string
}

string

Tên tài nguyên về Đối tượng.

{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}

string

Tên tài nguyên của bộ lọc nhóm trang thông tin của nhóm thành phần. Tên tài nguyên bộ lọc của nhóm trang thông tin của nhóm thành phần có dạng như sau:

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

string

Nhóm thành phần có bộ lọc nhóm trang thông tin của nhóm thành phần này.

string (int64 format)

Mã của ListGroupFilter.

enum (ListingGroupFilterType)

Loại nút bộ lọc nhóm trang thông tin.

enum (ListingGroupFilterVertical)

Dọc mà cây nút hiện tại đại diện. Tất cả các nút trong cùng một cây phải thuộc cùng một ngành dọc.

object (ListingGroupFilterDimension)

Giá trị phương diện mà nhóm trang thông tin này đang tinh chỉnh lại thành phần mẹ. Không xác định cho nhóm gốc.

string

Tên tài nguyên của nhóm phụ nhóm trang thông tin gốc. Giá trị rỗng cho nút bộ lọc nhóm trang thông tin gốc.

object (ListingGroupFilterDimensionPath)

Đường dẫn của các phương diện xác định bộ lọc nhóm trang thông tin này.

{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}

object (ProductBiddingCategory)

Danh mục đặt giá thầu của một sản phẩm.

object (ProductBrand)

Thương hiệu của sản phẩm được chào bán.

object (ProductChannel)

Thành phố của sản phẩm.

object (ProductCondition)

Điều kiện của ưu đãi sản phẩm.

object (ProductCustomAttribute)

Thuộc tính tuỳ chỉnh của ưu đãi sản phẩm.

object (ProductItemId)

Mã mặt hàng của ưu đãi sản phẩm.

object (ProductType)

Loại ưu đãi sản phẩm.

{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}

enum (ListingGroupFilterBiddingCategoryLevel)

Cho biết cấp của danh mục trong thông tin phân loại.

string (int64 format)

Mã nhận dạng của danh mục đặt giá thầu cho sản phẩm.

Mã này tương đương với mã google_product_category [danh_mục_sản_phẩm_của_Google] như mô tả trong bài viết này: https://support.google.com/merchants/answer/6324436

{
  "value": string
}

string

Giá trị chuỗi của thương hiệu sản phẩm.

{
  "channel": enum (ListingGroupFilterProductChannel)
}

enum (ListingGroupFilterProductChannel)

Giá trị của địa phương.