ExtensionFeedItem

Một 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.
}
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 phần mở rộng. 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 các lịch biểu không trùng lặp chỉ định tất 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 khi 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 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 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 hợp extension. Loại phần mở rộng. extension chỉ có thể là một trong những trạng thái sau:
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ừ Trang doanh nghiệp vào 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. 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 hợp serving_resource_targeting. Nhắm mục tiêu ở cấp chiến dịch hoặc nhóm quảng cáo. Những 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 cùng tài nguyên đó. serving_resource_targeting chỉ có thể là một trong những trạng thái sau:
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 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
}
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 thông tin. Chuỗi này không được để trống.

AppFeedItem

Đại diện cho một phần mở rộng về ứ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
}
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 các URL cuối cùng có thể xảy ra sau tất cả các lần chuyển hướng nhiều miền. Không được để trống danh sách này.
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ần chuyển hướng nhiều miền.
urlCustomParameters[]

object (CustomParameter)

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

string

Văn bản 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 này phải nằm trong khoảng từ 1 đến 25.
appId

string

Mã 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 thông 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 tiện ích ứng dụng.

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

TextMessageFeedItem

Tiện ích 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
}
Trường
businessName

string

Tên doanh nghiệp để 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 tin nhắn. Bắt buộc.
text

string

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

string

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

PriceFeedItem

Đại diện cho phần mở rộng về 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
}
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)

Các dịch vụ 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 ưu đãi của phần mở rộng về giá này.
languageCode

string

Mã của 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 ưu đãi của phần mở rộng về giá này.

PriceOffer

Đại diện cho một ưu đãi 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
}
Trường
price

object (Money)

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

enum (PriceExtensionPriceUnit)

Đơn vị giá cho mặt hàng này.
finalUrls[]

string

Danh sách các URL cuối cùng có thể xảy ra sau tất cả các lần 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ần 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ả của ư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.
}
Trường
discountModifier

enum (PromotionExtensionDiscountModifier)

Enum sửa đổ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 đặt một dịp, thì khoảng thời gian đổi thưởng cần phải nằm trong phạm vi ngày tương ứng với sự kiện đó.
finalUrls[]

string

Danh sách các URL cuối cùng có thể xảy ra sau tất cả các lần 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ần chuyển hướng nhiều miền.
urlCustomParameters[]

object (CustomParameter)

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

string

Nội dung mô tả dạng tự do về nội dung 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 thông 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 chương trình khuyến mãi. Được thể hiện dưới dạng thẻ ngôn ngữ BCP 47.
Trường hợp discount_type. Loại chiết khấu, có thể là giảm giá theo phần trăm hoặc giảm giá. discount_type chỉ có thể là một trong những hình thức sau:
percentOff

string (int64 format)

Chiết khấu phần trăm trong chương trình khuyến mãi cực nhỏ. Một triệu tương đương với 1 phần trăm. Đây là giá trị bắt buộc.
moneyAmountOff

object (Money)

Số tiền giảm giá trong chương trình khuyến mãi. Bạn phải áp dụng phần trăm chiết khấu hoặc phần trăm này.
Trường hợp promotion_trigger. Trình kích hoạt khuyến mãi. Có thể bằng mã khuyến mãi hoặc khuyến mãi theo số tiền hợp lệ của đơn đặt hàng. promotion_trigger chỉ có thể là một trong những trạng thái sau:
promotionCode

string

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

object (Money)

Số tiền của tổng đơn đặt hàng cần đạt được để 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
}
Trường
businessName

string

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

string

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

string

Dòng 2 của đị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
}
Trường
businessName

string

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

string

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

string

Dòng 2 của đị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 là người bán sản phẩm của bạn.
chainName

string

Tên chuỗi.

HotelCalloutFeedItem

Đại diện cho 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
}
Trường
text

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.
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ủ BCP 47 của IETF.

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

string

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