ExtensionFeedItem

Elemen feed ekstensi.

Representasi 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.
}
Kolom
resourceName

string

Tidak dapat diubah. Nama resource item feed ekstensi. Nama resource elemen feed ekstensi memiliki bentuk:

customers/{customerId}/extensionFeedItems/{feed_item_id}

extensionType

enum (ExtensionType)

Hanya output. Jenis ekstensi dari elemen feed ekstensi. Kolom ini bersifat hanya baca.

adSchedules[]

object (AdScheduleInfo)

Daftar jadwal yang tidak tumpang-tindih yang menentukan semua interval waktu item feed dapat ditayangkan. Maksimal 6 jadwal per hari.

device

enum (FeedItemTargetDevice)

Perangkat yang ditargetkan.

targetedKeyword

object (KeywordInfo)

Kata kunci yang ditargetkan.

status

enum (FeedItemStatus)

Hanya output. Status elemen feed. Kolom ini bersifat hanya baca.

id

string (int64 format)

Hanya output. ID elemen feed ini. Hanya baca.

startDateTime

string

Waktu mulai saat elemen feed ini efektif dan dapat mulai ditayangkan. Waktu ditampilkan dalam zona waktu pelanggan. Formatnya adalah "YYYY-MM-DD HH:MM:SS". Contoh: "2018-03-05 09:15:00" atau "2018-02-01 14:34:30"

endDateTime

string

Waktu berakhir saat elemen feed ini tidak lagi efektif dan akan berhenti ditayangkan. Waktu ditampilkan dalam zona waktu pelanggan. Formatnya adalah "YYYY-MM-DD HH:MM:SS". Contoh: "2018-03-05 09:15:00" atau "2018-02-01 14:34:30"

targetedGeoTargetConstant

string

Konstanta target geografis yang ditargetkan.

Kolom union extension. Jenis ekstensi. extension hanya ada berupa salah satu diantara berikut:
structuredSnippetFeedItem

object (StructuredSnippetFeedItem)

Ekstensi ringkasan terstruktur.

appFeedItem

object (AppFeedItem)

Ekstensi aplikasi.

callFeedItem

object (CallFeedItem)

Ekstensi panggilan.

calloutFeedItem

object (CalloutFeedItem)

Ekstensi info.

textMessageFeedItem

object (TextMessageFeedItem)

Ekstensi SMS.

priceFeedItem

object (PriceFeedItem)

Ekstensi harga.

promotionFeedItem

object (PromotionFeedItem)

ekstensi Promosi.

locationFeedItem

object (LocationFeedItem)

Hanya output. Ekstensi lokasi. Lokasi disinkronkan dari Profil Bisnis ke feed. Kolom ini bersifat hanya baca.

affiliateLocationFeedItem

object (AffiliateLocationFeedItem)

Hanya output. Ekstensi lokasi afiliasi. Lokasi feed diisi oleh Google Ads berdasarkan ID jaringan bisnis. Kolom ini bersifat hanya baca.

hotelCalloutFeedItem

object (HotelCalloutFeedItem)

Ekstensi Info Hotel.

imageFeedItem

object (ImageFeedItem)

Tidak dapat diubah. Ekstensi gambar yang disediakan pengiklan.

Kolom union serving_resource_targeting. Penargetan di tingkat kampanye atau grup iklan. Elemen feed yang menargetkan kampanye atau grup iklan hanya akan ditayangkan dengan resource tersebut. serving_resource_targeting hanya ada berupa salah satu diantara berikut:
targetedCampaign

string

Kampanye yang ditargetkan.

targetedAdGroup

string

Grup iklan yang ditargetkan.

StructuredSnippetFeedItem

Mewakili ekstensi ringkasan terstruktur.

Representasi JSON
{
  "values": [
    string
  ],
  "header": string
}
Kolom
values[]

string

Nilai dalam cuplikan. Ukuran maksimum koleksi ini adalah 10.

header

string

Header cuplikan. String ini tidak boleh kosong.

AppFeedItem

Menampilkan ekstensi Aplikasi.

Representasi JSON
{
  "appStore": enum (AppStore),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "linkText": string,
  "appId": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string
}
Kolom
appStore

enum (AppStore)

App store tempat aplikasi target berada. Kolom ini wajib diisi.

finalUrls[]

string

Daftar kemungkinan URL final setelah semua pengalihan lintas-domain. Daftar ini wajib diisi.

finalMobileUrls[]

string

Daftar kemungkinan URL seluler final setelah semua pengalihan lintas-domain.

urlCustomParameters[]

object (CustomParameter)

Daftar pemetaan yang akan digunakan untuk mengganti tag parameter kustom URL di trackingUrlTemplate, finalUrls, dan/atau finalMobileUrls.

appId

string

ID khusus toko untuk aplikasi target. String ini tidak boleh kosong.

trackingUrlTemplate

string

Template URL untuk membuat URL pelacakan. Nilai defaultnya adalah "{lpurl}".

finalUrlSuffix

string

Template URL untuk menambahkan parameter ke URL halaman landing yang ditayangkan dengan pelacakan paralel.

AppStore

Jenis app store di ekstensi aplikasi.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui pada versi ini.
APPLE_ITUNES Apple iTunes.
GOOGLE_PLAY Google Play.

TextMessageFeedItem

Ekstensi yang dapat diklik pengguna untuk mengirim SMS kepada pengiklan.

Representasi JSON
{
  "businessName": string,
  "countryCode": string,
  "phoneNumber": string,
  "text": string,
  "extensionText": string
}
Kolom
businessName

string

Nama bisnis yang akan ditambahkan ke teks pesan. Kolom ini wajib diisi.

countryCode

string

Gunakan huruf besar untuk dua huruf kode negara nomor telepon pengiklan. Kolom ini wajib diisi.

phoneNumber

string

Nomor telepon pengiklan yang akan dikirimi pesan. Wajib.

text

string

Teks yang akan ditampilkan di iklan. Kolom ini wajib diisi.

extensionText

string

ExtensionText pesan diisi di aplikasi pesan.

PriceFeedItem

Menampilkan ekstensi Harga.

Representasi JSON
{
  "type": enum (PriceExtensionType),
  "priceQualifier": enum (PriceExtensionPriceQualifier),
  "priceOfferings": [
    {
      object (PriceOffer)
    }
  ],
  "trackingUrlTemplate": string,
  "languageCode": string,
  "finalUrlSuffix": string
}
Kolom
type

enum (PriceExtensionType)

Jenis ekstensi harga ekstensi ini.

priceQualifier

enum (PriceExtensionPriceQualifier)

Penentu harga untuk semua penawaran ekstensi harga ini.

priceOfferings[]

object (PriceOffer)

Penawaran harga dalam ekstensi harga ini.

trackingUrlTemplate

string

Template URL pelacakan untuk semua penawaran ekstensi harga ini.

languageCode

string

Kode bahasa yang digunakan untuk ekstensi harga ini.

finalUrlSuffix

string

Template URL pelacakan untuk semua penawaran ekstensi harga ini.

PriceOffer

Mewakili satu penawaran harga dalam ekstensi harga.

Representasi JSON
{
  "price": {
    object (Money)
  },
  "unit": enum (PriceExtensionPriceUnit),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "header": string,
  "description": string
}
Kolom
price

object (Money)

Nilai harga penawaran ini.

unit

enum (PriceExtensionPriceUnit)

Unit harga untuk penawaran ini.

finalUrls[]

string

Daftar kemungkinan URL final setelah semua pengalihan lintas-domain.

finalMobileUrls[]

string

Daftar kemungkinan URL seluler final setelah semua pengalihan lintas-domain.

header

string

Teks header penawaran ini.

description

string

Teks deskripsi penawaran ini.

PromotionFeedItem

Mewakili ekstensi Promosi.

Representasi 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.
}
Kolom
discountModifier

enum (PromotionExtensionDiscountModifier)

Enum yang mengubah kualifikasi diskon.

occasion

enum (PromotionExtensionOccasion)

Acara yang dimaksudkan untuk promosi. Jika acara ditetapkan, periode penukaran harus berada dalam rentang tanggal yang dikaitkan dengan acara tersebut.

finalUrls[]

string

Daftar kemungkinan URL final setelah semua pengalihan lintas-domain. Kolom ini wajib diisi.

finalMobileUrls[]

string

Daftar kemungkinan URL seluler final setelah semua pengalihan lintas-domain.

urlCustomParameters[]

object (CustomParameter)

Daftar pemetaan yang akan digunakan untuk mengganti tag parameter kustom URL di trackingUrlTemplate, finalUrls, dan/atau finalMobileUrls.

promotionTarget

string

Deskripsi bebas tentang hal yang ditargetkan promosi. Kolom ini wajib diisi.

promotionStartDate

string

Tanggal mulai saat promosi memenuhi syarat untuk ditukarkan.

promotionEndDate

string

Tanggal terakhir saat promosi memenuhi syarat untuk ditukarkan.

trackingUrlTemplate

string

Template URL untuk membuat URL pelacakan.

finalUrlSuffix

string

Template URL untuk menambahkan parameter ke URL halaman landing yang ditayangkan dengan pelacakan paralel.

languageCode

string

Bahasa promosi. Direpresentasikan sebagai tag bahasa BCP 47.

Kolom union discount_type. Jenis diskon, dapat berupa persentase potongan atau potongan jumlah. discount_type hanya dapat berupa salah satu dari yang berikut:
percentOff

string (int64 format)

Diskon persentase diskon dalam promosi dalam mikro. Satu juta setara dengan satu persen. Ini atau uang_off_amount wajib diisi.

moneyAmountOff

object (Money)

Jumlah uang potongan untuk diskon dalam promosi. Opsi ini atau persenOff diperlukan.

Kolom union promotion_trigger. Pemicu promosi. Dapat diberikan dengan kode promosi atau promo berdasarkan jumlah pesanan yang memenuhi syarat. promotion_trigger hanya ada berupa salah satu diantara berikut:
promotionCode

string

Kode yang harus digunakan pengguna agar memenuhi syarat untuk promosi.

ordersOverAmount

object (Money)

Jumlah total pesanan yang harus dimiliki pengguna agar memenuhi syarat untuk promosi.

LocationFeedItem

Mewakili ekstensi lokasi.

Representasi JSON
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string
}
Kolom
businessName

string

Nama bisnis.

addressLine1

string

Baris 1 alamat bisnis.

addressLine2

string

Baris 2 alamat bisnis.

city

string

Kota alamat bisnis.

province

string

Provinsi alamat bisnis.

postalCode

string

Kode pos alamat bisnis.

countryCode

string

Kode negara alamat bisnis.

phoneNumber

string

Nomor telepon bisnis.

AffiliateLocationFeedItem

Mewakili ekstensi lokasi afiliasi.

Representasi JSON
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string,
  "chainId": string,
  "chainName": string
}
Kolom
businessName

string

Nama bisnis.

addressLine1

string

Baris 1 alamat bisnis.

addressLine2

string

Baris 2 alamat bisnis.

city

string

Kota alamat bisnis.

province

string

Provinsi alamat bisnis.

postalCode

string

Kode pos alamat bisnis.

countryCode

string

Kode negara alamat bisnis.

phoneNumber

string

Nomor telepon bisnis.

chainId

string (int64 format)

ID jaringan retail yang diiklankan sebagai penjual produk Anda.

chainName

string

Nama jaringan bisnis.

HotelCalloutFeedItem

Mewakili ekstensi info hotel.

Representasi JSON
{
  "text": string,
  "languageCode": string
}
Kolom
text

string

Teks info. Panjang string ini harus antara 1 dan 25, inklusif.

languageCode

string

Bahasa teks info hotel. Kode bahasa yang sesuai dengan IETF BCP 47.

ImageFeedItem

Mewakili ekstensi gambar yang disediakan pengiklan.

Representasi JSON
{
  "imageAsset": string
}
Kolom
imageAsset

string

Wajib. Nama resource aset gambar.