ExtensionFeedItem

Mục nguồn cấp dữ liệu của phần mở rộng.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "extensionType": enum (ExtensionType),
  "adSchedules": [
    {
      object (AdScheduleInfo)
    }
  ],
  "device": enum (FeedItemTargetDevice),
  "targetedKeyword": {
    object (KeywordInfo)
  },
  "status": enum (FeedItemStatus),
  "id": string,
  "startDateTime": string,
  "endDateTime": string,
  "targetedGeoTargetConstant": string,

  // Union field extension can be only one of the following:
  "sitelinkFeedItem": {
    object (SitelinkFeedItem)
  },
  "structuredSnippetFeedItem": {
    object (StructuredSnippetFeedItem)
  },
  "appFeedItem": {
    object (AppFeedItem)
  },
  "callFeedItem": {
    object (CallFeedItem)
  },
  "calloutFeedItem": {
    object (CalloutFeedItem)
  },
  "textMessageFeedItem": {
    object (TextMessageFeedItem)
  },
  "priceFeedItem": {
    object (PriceFeedItem)
  },
  "promotionFeedItem": {
    object (PromotionFeedItem)
  },
  "locationFeedItem": {
    object (LocationFeedItem)
  },
  "affiliateLocationFeedItem": {
    object (AffiliateLocationFeedItem)
  },
  "hotelCalloutFeedItem": {
    object (HotelCalloutFeedItem)
  },
  "imageFeedItem": {
    object (ImageFeedItem)
  }
  // End of list of possible types for union field extension.

  // Union field serving_resource_targeting can be only one of the following:
  "targetedCampaign": string,
  "targetedAdGroup": string
  // End of list of possible types for union field serving_resource_targeting.
}
Các trường
resourceName

string

Không thể thay đổi. Tên tài nguyên của mục nguồn cấp dữ liệu tiện ích. Tên tài nguyên mục nguồn cấp dữ liệu của phần mở rộng có dạng:

customers/{customerId}/extensionFeedItems/{feed_item_id}
extensionType

enum (ExtensionType)

Chỉ có đầu ra. Loại phần mở rộng của mục nguồn cấp dữ liệu phần mở rộng. Trường này chỉ để đọc.
adSchedules[]

object (AdScheduleInfo)

Danh sách lịch biểu không trùng lặp chỉ định tất cả các khoảng thời gian mà mục nguồn cấp dữ liệu có thể phân phát. Có thể có tối đa 6 lịch biểu mỗi ngày.
device

enum (FeedItemTargetDevice)

Thiết bị mục tiêu.
targetedKeyword

object (KeywordInfo)

Từ khoá được nhắm mục tiêu.
status

enum (FeedItemStatus)

Chỉ có đầu ra. Trạng thái của mục nguồn cấp dữ liệu. Trường này chỉ để đọc.
id

string (int64 format)

Chỉ có đầu ra. Mã của mục nguồn cấp dữ liệu này. Chỉ đọc.
startDateTime

string

Thời gian bắt đầu mà mục nguồn cấp dữ liệu này có hiệu lực và có thể bắt đầu phân phát. Thời gian được tính theo múi giờ của khách hàng. Định dạng là "YYYY-MM-DD HH:MM:SS". Ví dụ: "2018-03-05 09:15:00" hoặc "2018-02-01 14:34:30"
endDateTime

string

Thời gian kết thúc khi mục nguồn cấp dữ liệu này không còn hiệu quả và sẽ ngừng phân phát. Thời gian được tính theo múi giờ của khách hàng. Định dạng là "YYYY-MM-DD HH:MM:SS". Ví dụ: "2018-03-05 09:15:00" hoặc "2018-02-01 14:34:30"
targetedGeoTargetConstant

string

Hằng số mục tiêu địa lý được nhắm mục tiêu.
Trường nhóm extension. Loại phần mở rộng. extension chỉ có thể là một trong những trạng thái sau đây:
structuredSnippetFeedItem

object (StructuredSnippetFeedItem)

Phần mở rộng về đoạn thông tin có cấu trúc.
appFeedItem

object (AppFeedItem)

Phần mở rộng về ứng dụng.
callFeedItem

object (CallFeedItem)

Phần mở rộng về cuộc gọi.
calloutFeedItem

object (CalloutFeedItem)

Tiện ích chú thích.
textMessageFeedItem

object (TextMessageFeedItem)

Phần mở rộng về tin nhắn văn bản.
priceFeedItem

object (PriceFeedItem)

Phần mở rộng về giá.
promotionFeedItem

object (PromotionFeedItem)

Tiện ích khuyến mại.
locationFeedItem

object (LocationFeedItem)

Chỉ có đầu ra. Tiện ích vị trí. Các địa điểm được đồng bộ hoá từ một Trang doanh nghiệp vào một nguồn cấp dữ liệu. Trường này chỉ để đọc.
affiliateLocationFeedItem

object (AffiliateLocationFeedItem)

Chỉ có đầu ra. Phần mở rộng về địa điểm của đơn vị liên kết. Các vị trí trong nguồn cấp dữ liệu được Google Ads điền sẵn dựa trên mã chuỗi. Trường này chỉ để đọc.
hotelCalloutFeedItem

object (HotelCalloutFeedItem)

Phần mở rộng về chú thích cho khách sạn.
imageFeedItem

object (ImageFeedItem)

Không thể thay đổi. Phần mở rộng về hình ảnh do nhà quảng cáo cung cấp.
Trường nhóm serving_resource_targeting. Nhắm mục tiêu ở cấp chiến dịch hoặc nhóm quảng cáo. Mục trong nguồn cấp dữ liệu nhắm đến một chiến dịch hoặc nhóm quảng cáo sẽ chỉ phân phát với tài nguyên đó. serving_resource_targeting chỉ có thể là một trong những trạng thái sau đây:
targetedCampaign

string

Chiến dịch được nhắm mục tiêu.
targetedAdGroup

string

Nhóm quảng cáo được nhắm mục tiêu.

StructuredSnippetFeedItem

Đại diện cho một phần mở rộng về đoạn thông tin có cấu trúc.

Biểu diễn dưới dạng JSON 
{
  "values": [
    string
  ],
  "header": string
}
Các trường
values[]

string

Các giá trị trong đoạn mã. Kích thước tối đa của bộ sưu tập này là 10.
header

string

Tiêu đề của đoạn trích. Chuỗi này không được để trống.

AppFeedItem

Đại diện cho một Tiện ích ứng dụng.

Biểu diễn dưới dạng JSON 
{
  "appStore": enum (AppStore),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "linkText": string,
  "appId": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string
}
Các trường
appStore

enum (AppStore)

Cửa hàng ứng dụng chứa ứng dụng mục tiêu. Trường này là bắt buộc.
finalUrls[]

string

Danh sách URL cuối cùng có thể dùng sau tất cả các lượt chuyển hướng nhiều miền. Danh sách này không được để trống.
finalMobileUrls[]

string

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

object (CustomParameter)

Danh sách các mục ánh xạ được dùng để thay thế các thẻ thông số tuỳ chỉnh của URL trong trackUrlTemplate, lastUrls và/hoặc lastMobileUrls.
linkText

string

Văn bản hiển thị xuất hiện khi đường liên kết xuất hiện trong quảng cáo. Chuỗi này không được để trống và độ dài của chuỗi phải nằm trong khoảng từ 1 đến 25.
appId

string

Mã cụ thể của từng cửa hàng cho ứng dụng mục tiêu. Chuỗi này không được để trống.
trackingUrlTemplate

string

Mẫu URL để tạo URL theo dõi. Giá trị mặc định là "{lpurl}".
finalUrlSuffix

string

Mẫu URL để thêm các tham số vào URL trang đích được phân phát cùng với tính năng theo dõi song song.

AppStore

Loại cửa hàng ứng dụng trong phần mở rộng về ứng dụng.

Enum
UNSPECIFIED Chưa xác định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
APPLE_ITUNES iTunes của Apple.
GOOGLE_PLAY Google Play.

TextMessageFeedItem

Phần mở rộng mà người dùng có thể nhấp vào để gửi tin nhắn văn bản cho nhà quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "businessName": string,
  "countryCode": string,
  "phoneNumber": string,
  "text": string,
  "extensionText": string
}
Các trường
businessName

string

Tên doanh nghiệp cần thêm vào trước nội dung tin nhắn. Trường này là bắt buộc.
countryCode

string

Mã quốc gia gồm hai chữ cái viết hoa trong số điện thoại của nhà quảng cáo. Trường này là bắt buộc.
phoneNumber

string

Số điện thoại của nhà quảng cáo sẽ nhận được tin nhắn. Bắt buộc.
text

string

Văn bản sẽ hiển thị trong quảng cáo. Trường này là bắt buộc.
extensionText

string

Phần mở rộng về tin nhắn Text được điền sẵn trong ứng dụng nhắn tin.

PriceFeedItem

Đại diện cho phần mở rộng Giá.

Biểu diễn dưới dạng JSON 
{
  "type": enum (PriceExtensionType),
  "priceQualifier": enum (PriceExtensionPriceQualifier),
  "priceOfferings": [
    {
      object (PriceOffer)
    }
  ],
  "trackingUrlTemplate": string,
  "languageCode": string,
  "finalUrlSuffix": string
}
Các trường
type

enum (PriceExtensionType)

Loại phần mở rộng về giá của phần mở rộng này.
priceQualifier

enum (PriceExtensionPriceQualifier)

Bộ định giá cho tất cả các ưu đãi của phần mở rộng về giá này.
priceOfferings[]

object (PriceOffer)

Ưu đãi về giá trong phần mở rộng về giá này.
trackingUrlTemplate

string

Mẫu URL theo dõi cho tất cả các mặt hàng của phần mở rộng về giá này.
languageCode

string

Mã ngôn ngữ dùng cho phần mở rộng về giá này.
finalUrlSuffix

string

Mẫu URL theo dõi cho tất cả các mặt hàng của phần mở rộng về giá này.

PriceOffer

Đại diện cho một ưu đãi về giá trong phần mở rộng về giá.

Biểu diễn dưới dạng JSON 
{
  "price": {
    object (Money)
  },
  "unit": enum (PriceExtensionPriceUnit),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "header": string,
  "description": string
}
Các trường
price

object (Money)

Giá trị của ưu đãi này.
unit

enum (PriceExtensionPriceUnit)

Đơn vị giá cho ưu đãi này.
finalUrls[]

string

Danh sách URL cuối cùng có thể dùng sau tất cả các lượt chuyển hướng nhiều miền.
finalMobileUrls[]

string

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

string

Văn bản tiêu đề của ưu đãi này.
description

string

Văn bản mô tả về ưu đãi này.

PromotionFeedItem

Đại diện cho phần mở rộng về Khuyến mại.

Biểu diễn dưới dạng JSON 
{
  "discountModifier": enum (PromotionExtensionDiscountModifier),
  "occasion": enum (PromotionExtensionOccasion),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "promotionTarget": string,
  "promotionStartDate": string,
  "promotionEndDate": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "languageCode": string,

  // Union field discount_type can be only one of the following:
  "percentOff": string,
  "moneyAmountOff": {
    object (Money)
  }
  // End of list of possible types for union field discount_type.

  // Union field promotion_trigger can be only one of the following:
  "promotionCode": string,
  "ordersOverAmount": {
    object (Money)
  }
  // End of list of possible types for union field promotion_trigger.
}
Các trường
discountModifier

enum (PromotionExtensionDiscountModifier)

Enum sửa đổi trạng thái đủ điều kiện của khoản chiết khấu.
occasion

enum (PromotionExtensionOccasion)

Dịp áp dụng chương trình khuyến mãi. Nếu bạn thiết lập một dịp, khoảng thời gian đổi thưởng cần phải nằm trong phạm vi ngày liên quan đến dịp đó.
finalUrls[]

string

Danh sách URL cuối cùng có thể dùng sau tất cả các lượt chuyển hướng nhiều miền. Trường này là bắt buộc.
finalMobileUrls[]

string

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

object (CustomParameter)

Danh sách các mục ánh xạ được dùng để thay thế các thẻ thông số tuỳ chỉnh của URL trong trackUrlTemplate, lastUrls và/hoặc lastMobileUrls.
promotionTarget

string

Nội dung mô tả dạng tự do về đối tượng mà chương trình khuyến mãi nhắm đến. Trường này là bắt buộc.
promotionStartDate

string

Ngày bắt đầu khi chương trình khuyến mãi đủ điều kiện để sử dụng.
promotionEndDate

string

Ngày cuối cùng khi chương trình khuyến mãi đủ điều kiện để sử dụng.
trackingUrlTemplate

string

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

string

Mẫu URL để thêm các tham số vào URL trang đích được phân phát cùng với tính năng theo dõi song song.
languageCode

string

Ngôn ngữ của quảng cáo. Được biểu thị dưới dạng thẻ ngôn ngữ BCP 47.
Trường nhóm discount_type. Loại chiết khấu, có thể là phần trăm giảm giá hoặc số tiền giảm giá. discount_type chỉ có thể là một trong những loại sau:
percentOff

string (int64 format)

Phần trăm giảm giá chiết khấu trong chương trình khuyến mãi theo kích thước cực nhỏ. 1 triệu tương đương với 1%. Bắt buộc phải có số tiền này hoặc amount_off_amount.
moneyAmountOff

object (Money)

Số tiền giảm giá trong chương trình khuyến mãi. Bạn phải bật tính năng này hoặc %Off.
Trường nhóm promotion_trigger. Trình kích hoạt quảng cáo. Có thể thông qua mã khuyến mãi hoặc khuyến mãi theo số tiền đủ điều kiện của đơn đặt hàng. promotion_trigger chỉ có thể là một trong những trạng thái sau đây:
promotionCode

string

Mã mà người dùng phải sử dụng để đủ điều kiện hưởng chương trình khuyến mãi.
ordersOverAmount

object (Money)

Số tiền của tổng đơn đặt hàng cần phải là để người dùng đủ điều kiện tham gia chương trình khuyến mãi.

LocationFeedItem

Đại diện cho một phần mở rộng về địa điểm.

Biểu diễn dưới dạng JSON 
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string
}
Các trường
businessName

string

Tên của doanh nghiệp.
addressLine1

string

Dòng 1 trong địa chỉ doanh nghiệp.
addressLine2

string

Dòng 2 trong địa chỉ doanh nghiệp.
city

string

Thành phố của địa chỉ doanh nghiệp.
province

string

Tỉnh của địa chỉ doanh nghiệp.
postalCode

string

Mã bưu chính của địa chỉ doanh nghiệp.
countryCode

string

Mã quốc gia của địa chỉ doanh nghiệp.
phoneNumber

string

Số điện thoại của doanh nghiệp.

AffiliateLocationFeedItem

Đại diện cho một phần mở rộng về địa điểm của đơn vị liên kết.

Biểu diễn dưới dạng JSON 
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string,
  "chainId": string,
  "chainName": string
}
Các trường
businessName

string

Tên của doanh nghiệp.
addressLine1

string

Dòng 1 trong địa chỉ doanh nghiệp.
addressLine2

string

Dòng 2 trong địa chỉ doanh nghiệp.
city

string

Thành phố của địa chỉ doanh nghiệp.
province

string

Tỉnh của địa chỉ doanh nghiệp.
postalCode

string

Mã bưu chính của địa chỉ doanh nghiệp.
countryCode

string

Mã quốc gia của địa chỉ doanh nghiệp.
phoneNumber

string

Số điện thoại của doanh nghiệp.
chainId

string (int64 format)

Mã của chuỗi bán lẻ được quảng cáo với tư cách là người bán sản phẩm của bạn.
chainName

string

Tên chuỗi.

HotelCalloutFeedItem

Đại diện cho một phần mở rộng về chú thích cho khách sạn.

Biểu diễn dưới dạng JSON 
{
  "text": string,
  "languageCode": string
}
Các trường
text

string

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

string

Ngôn ngữ của văn bản chú thích cho khách sạn. Mã ngôn ngữ tuân thủ IETF BCP 47.

ImageFeedItem

Đại diện cho phần mở rộng về hình ảnh do nhà quảng cáo cung cấp.

Biểu diễn dưới dạng JSON 
{
  "imageAsset": string
}
Các trường
imageAsset

string

Bắt buộc. Tên tài nguyên của thành phần hình ảnh.