ExtensionFeedItem

Uzantı feed öğesi.

JSON gösterimi
{
  "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.
}
Alanlar
resourceName

string

Sabit. Uzantı feed öğesinin kaynak adı. Uzantı feed öğesi kaynak adları şu biçimdedir:

customers/{customerId}/extensionFeedItems/{feed_item_id}

extensionType

enum (ExtensionType)

Yalnızca çıkış. Uzantı feed öğesinin uzantı türü. Bu alan salt okunurdur.

adSchedules[]

object (AdScheduleInfo)

Feed öğesinin yayınlanabileceği tüm zaman aralıklarını belirten, çakışmayan programların listesi. Günde en fazla 6 program olabilir.

device

enum (FeedItemTargetDevice)

Hedeflenen cihaz.

targetedKeyword

object (KeywordInfo)

Hedeflenen anahtar kelime.

status

enum (FeedItemStatus)

Yalnızca çıkış. Feed öğesinin durumu. Bu alan salt okunurdur.

id

string (int64 format)

Yalnızca çıkış. Bu feed öğesinin kimliği. Salt okunurdur.

startDateTime

string

Bu feed öğesinin etkili olduğu ve yayınlanmaya başlayabileceği başlangıç zamanı. Saat, müşterinin saat dilimindedir. Biçim, "YYYY-AA-GG SS:DD:SS" şeklindedir. Örnekler: "2018-03-05 09:15:00" veya "2018-02-01 14:34:30"

endDateTime

string

Bu feed öğesinin artık etkili olmadığı ve yayınının durdurulacağı bitiş zamanı. Saat, müşterinin saat dilimindedir. Biçim, "YYYY-AA-GG SS:DD:SS" şeklindedir. Örnekler: "2018-03-05 09:15:00" veya "2018-02-01 14:34:30"

targetedGeoTargetConstant

string

Hedeflenen coğrafi hedef sabiti.

Birleştirme alanı extension. Uzantı türü. extension şunlardan yalnızca biri olabilir:
structuredSnippetFeedItem

object (StructuredSnippetFeedItem)

Ek açıklamalı snippet uzantısı'nı tıklayın.

appFeedItem

object (AppFeedItem)

Uygulama uzantısı'nı seçin.

callFeedItem

object (CallFeedItem)

Telefon uzantısı'nı seçin.

calloutFeedItem

object (CalloutFeedItem)

Açıklama metni uzantısı'nı tıklayın.

textMessageFeedItem

object (TextMessageFeedItem)

Kısa mesaj uzantısı.

priceFeedItem

object (PriceFeedItem)

Fiyat uzantısı'nı seçin.

promotionFeedItem

object (PromotionFeedItem)

Promosyon uzantısı'nı seçin.

locationFeedItem

object (LocationFeedItem)

Yalnızca çıkış. Yer uzantısı'nı seçin. Konumlar, bir İşletme Profili'nden feed'e senkronize edilir. Bu alan salt okunurdur.

affiliateLocationFeedItem

object (AffiliateLocationFeedItem)

Yalnızca çıkış. Satış ortağı yer uzantısı. Feed konumları, Google Ads tarafından zincir kimliğine göre doldurulur. Bu alan salt okunurdur.

hotelCalloutFeedItem

object (HotelCalloutFeedItem)

Otel Açıklama Metni uzantısı.

imageFeedItem

object (ImageFeedItem)

Sabit. Reklamveren tarafından sağlanan resim uzantısı.

Birleştirme alanı serving_resource_targeting. Kampanya veya reklam grubu düzeyinde hedefleme. Bir kampanyayı veya reklam grubunu hedefleyen feed öğeleri yalnızca bu kaynakla yayınlanır. serving_resource_targeting şunlardan yalnızca biri olabilir:
targetedCampaign

string

Hedeflenen kampanya.

targetedAdGroup

string

Hedeflenen reklam grubu.

StructuredSnippetFeedItem

Ek açıklamalı snippet uzantısını temsil eder.

JSON gösterimi
{
  "values": [
    string
  ],
  "header": string
}
Alanlar
values[]

string

Snippet'teki değerler. Bu koleksiyonun maksimum boyutu 10'dur.

header

string

Snippet'in başlığı. Bu dize boş olmamalıdır.

AppFeedItem

Bir uygulama uzantısını temsil eder.

JSON gösterimi
{
  "appStore": enum (AppStore),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "linkText": string,
  "appId": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string
}
Alanlar
appStore

enum (AppStore)

Hedef uygulamanın ait olduğu uygulama mağazası. Bu alan zorunludur.

finalUrls[]

string

Tüm alanlar arası yönlendirmelerden sonraki olası nihai URL'lerin listesi. Bu liste boş olmamalıdır.

finalMobileUrls[]

string

Tüm alanlar arası yönlendirmelerden sonraki olası mobil nihai URL'lerin listesi.

urlCustomParameters[]

object (CustomParameter)

trackingUrlTemplate, finalUrls ve/veya finalMobileUrls öğelerinde URL özel parametre etiketlerini değiştirmek için kullanılacak eşlemelerin listesi.

appId

string

Hedef uygulamanın mağazaya özgü kimliği. Bu dize boş olmamalıdır.

trackingUrlTemplate

string

İzleme URL'si oluşturmaya yönelik URL şablonu. Varsayılan değer "{lpurl}" şeklindedir.

finalUrlSuffix

string

Paralel izleme ile sunulan açılış sayfası URL'lerine parametreleri eklemek için kullanılan URL şablonu.

AppStore

Bir uygulama uzantısındaki uygulama mağazası türü.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
APPLE_ITUNES Apple iTunes'a gidin.
GOOGLE_PLAY Google Play.

TextMessageFeedItem

Kullanıcıların reklamverene kısa mesaj göndermek için tıklayabilecekleri bir uzantı.

JSON gösterimi
{
  "businessName": string,
  "countryCode": string,
  "phoneNumber": string,
  "text": string,
  "extensionText": string
}
Alanlar
businessName

string

Mesaj metninin başına eklenecek işletme adı. Bu alan zorunludur.

countryCode

string

Reklamverenin telefon numarasının büyük iki harfli ülke kodu. Bu alan zorunludur.

phoneNumber

string

Mesajın gönderileceği reklamverenin telefon numarası. Zorunlu.

text

string

Reklamda gösterilecek metin. Bu alan zorunludur.

extensionText

string

Mesajlaşma uygulamasında mesaj uzantısıText alanı doldurulur.

PriceFeedItem

Bir Fiyat uzantısını temsil eder.

JSON gösterimi
{
  "type": enum (PriceExtensionType),
  "priceQualifier": enum (PriceExtensionPriceQualifier),
  "priceOfferings": [
    {
      object (PriceOffer)
    }
  ],
  "trackingUrlTemplate": string,
  "languageCode": string,
  "finalUrlSuffix": string
}
Alanlar
type

enum (PriceExtensionType)

Bu uzantının fiyat uzantısı türü.

priceQualifier

enum (PriceExtensionPriceQualifier)

Bu fiyat uzantısındaki tüm teklifler için fiyat niteleyici.

priceOfferings[]

object (PriceOffer)

Bu fiyat uzantısındaki fiyat teklifleri.

trackingUrlTemplate

string

Bu fiyat uzantısındaki tüm teklifler için izleme URL'si şablonu.

languageCode

string

Bu fiyat uzantısı için kullanılan dilin kodu.

finalUrlSuffix

string

Bu fiyat uzantısındaki tüm teklifler için izleme URL'si şablonu.

PriceOffer

Bir fiyat uzantısındaki fiyat teklifini temsil eder.

JSON gösterimi
{
  "price": {
    object (Money)
  },
  "unit": enum (PriceExtensionPriceUnit),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "header": string,
  "description": string
}
Alanlar
price

object (Money)

Bu teklifin fiyat değeri.

unit

enum (PriceExtensionPriceUnit)

Bu teklif için fiyat birimi.

finalUrls[]

string

Tüm alanlar arası yönlendirmelerden sonraki olası nihai URL'lerin listesi.

finalMobileUrls[]

string

Tüm alanlar arası yönlendirmelerden sonraki olası mobil nihai URL'lerin listesi.

header

string

Bu teklifin başlık metni.

description

string

Bu teklifle ilgili açıklama metni.

PromotionFeedItem

Bir Promosyon uzantısını temsil ediyor.

JSON gösterimi
{
  "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.
}
Alanlar
discountModifier

enum (PromotionExtensionDiscountModifier)

İndirimin niteliklerini değiştiren numaralandırma.

occasion

enum (PromotionExtensionOccasion)

Promosyonun amaçlandığı özel gün. Özel bir gün ayarlanmışsa teklifi kullanma aralığının özel günle ilişkilendirilen tarih aralığına denk gelmesi gerekir.

finalUrls[]

string

Tüm alanlar arası yönlendirmelerden sonraki olası nihai URL'lerin listesi. Bu alan zorunludur.

finalMobileUrls[]

string

Tüm alanlar arası yönlendirmelerden sonraki olası mobil nihai URL'lerin listesi.

urlCustomParameters[]

object (CustomParameter)

trackingUrlTemplate, finalUrls ve/veya finalMobileUrls öğelerinde URL özel parametre etiketlerini değiştirmek için kullanılacak eşlemelerin listesi.

promotionTarget

string

Promosyonun neyi hedeflediğine dair serbest biçimli bir açıklama. Bu alan zorunludur.

promotionStartDate

string

Promosyonun kullanılmaya uygun olduğu başlangıç tarihidir.

promotionEndDate

string

Promosyonun kullanılmaya uygun olduğu son tarih.

trackingUrlTemplate

string

İzleme URL'si oluşturmaya yönelik URL şablonu.

finalUrlSuffix

string

Paralel izleme ile sunulan açılış sayfası URL'lerine parametreleri eklemek için kullanılan URL şablonu.

languageCode

string

Promosyonun dilidir. BCP 47 dil etiketi olarak gösterilir.

Birleştirme alanı discount_type. İndirim türü, yüzdelik indirim veya belirli bir tutarda indirim olabilir. discount_type aşağıdakilerden yalnızca biri olabilir:
percentOff

string (int64 format)

Promosyondaki indirimin yüzdesi (mikro ölçekte). Bir milyon, yüzde bire eşittir. Bu veya para_indirim_tutarı gereklidir.

moneyAmountOff

object (Money)

Promosyondaki indirim tutarı. Bu veya Yüzde Kapalı değeri gereklidir.

Birleştirme alanı promotion_trigger. Promosyon tetikleyicisi. Uygun sipariş tutarına göre promosyon kodu veya promosyon şeklinde olabilir. promotion_trigger şunlardan yalnızca biri olabilir:
promotionCode

string

Kullanıcının promosyondan yararlanabilmek için kullanması gereken kod.

ordersOverAmount

object (Money)

Kullanıcının promosyondan yararlanmaya uygun olması için toplam sipariş tutarı.

LocationFeedItem

Bir yer uzantısını temsil eder.

JSON gösterimi
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string
}
Alanlar
businessName

string

İşletmenin adı.

addressLine1

string

İşletme adresinin 1. satırı.

addressLine2

string

İşletme adresinin 2. satırı.

city

string

İşletme adresinin bulunduğu şehir.

province

string

İşletme adresinin bulunduğu il.

postalCode

string

İşletme adresinin posta kodu.

countryCode

string

İşletme adresinin ülke kodu.

phoneNumber

string

İşletmenin telefon numarası.

AffiliateLocationFeedItem

Bir satış ortağı yer uzantısını temsil ediyor.

JSON gösterimi
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string,
  "chainId": string,
  "chainName": string
}
Alanlar
businessName

string

İşletmenin adı.

addressLine1

string

İşletme adresinin 1. satırı.

addressLine2

string

İşletme adresinin 2. satırı.

city

string

İşletme adresinin bulunduğu şehir.

province

string

İşletme adresinin bulunduğu il.

postalCode

string

İşletme adresinin posta kodu.

countryCode

string

İşletme adresinin ülke kodu.

phoneNumber

string

İşletmenin telefon numarası.

chainId

string (int64 format)

Ürününüzün satıcısı olarak reklamı yapılan perakende zincirinin kimliği.

chainName

string

Zincirin adı.

HotelCalloutFeedItem

Otel açıklama metni uzantısını temsil eder.

JSON gösterimi
{
  "text": string,
  "languageCode": string
}
Alanlar
text

string

Açıklama metni. Bu dizenin uzunluğu 1 ile 25 arasında (1 ve 25 dahil) olmalıdır.

languageCode

string

Otel açıklama metninin dilidir. IETF BCP 47 uyumlu dil kodu.

ImageFeedItem

Reklamveren tarafından sağlanan resim uzantısını temsil eder.

JSON gösterimi
{
  "imageAsset": string
}
Alanlar
imageAsset

string

Zorunlu. Resim öğesinin kaynak adı.