ExtensionFeedItem

Element kanału – rozszerzenie.

Zapis 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.
}
Pola
resourceName

string

Stałe. Nazwa zasobu elementu kanału rozszerzenia. Nazwy zasobów elementu kanału rozszerzenia mają postać:

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

enum (ExtensionType)

Tylko dane wyjściowe. Typ rozszerzenia elementu kanału rozszerzenia. To pole jest tylko do odczytu.
adSchedules[]

object (AdScheduleInfo)

Lista nienakładających się harmonogramów określająca wszystkie przedziały czasowe, w których element kanału może się wyświetlać. Można ustawić maksymalnie 6 harmonogramów na dzień.
device

enum (FeedItemTargetDevice)

Urządzenie docelowe.
targetedKeyword

object (KeywordInfo)

Wybrane słowo kluczowe.
status

enum (FeedItemStatus)

Tylko dane wyjściowe. Stan elementu kanału. To pole jest tylko do odczytu.
id

string (int64 format)

Tylko dane wyjściowe. Identyfikator tego elementu kanału. Tylko do odczytu.
startDateTime

string

Godzina rozpoczęcia, w której ten element pliku danych jest aktywny i może się rozpocząć wyświetlanie. Czas jest podany w strefie czasowej klienta. Format to „RRRR-MM-DD GG:MM:SS”. Przykłady: „2018-03-05 09:15:00” lub „2018-02-01 14:34:30”.
endDateTime

string

Czas zakończenia, w którym ten element pliku danych przestanie być aktywny i przestanie wyświetlać reklamy. Czas jest podany w strefie czasowej klienta. Format to „RRRR-MM-DD GG:MM:SS”. Przykłady: „2018-03-05 09:15:00” lub „2018-02-01 14:34:30”.
targetedGeoTargetConstant

string

Stała docelowa kierowania geograficznego.
Pole sumy extension. Typ rozszerzenia. extension może być tylko jedną z tych wartości:
structuredSnippetFeedItem

object (StructuredSnippetFeedItem)

Rozszerzenie informacji w witrynie.
appFeedItem

object (AppFeedItem)

Rozszerzenie aplikacji.
callFeedItem

object (CallFeedItem)

Rozszerzenie połączenia.
calloutFeedItem

object (CalloutFeedItem)

Rozszerzenie objaśnień.
textMessageFeedItem

object (TextMessageFeedItem)

Rozszerzenie wiadomości.
priceFeedItem

object (PriceFeedItem)

Rozszerzenie cen.
promotionFeedItem

object (PromotionFeedItem)

Rozszerzenie promocji.
locationFeedItem

object (LocationFeedItem)

Tylko dane wyjściowe. Rozszerzenie lokalizacji. Lokalizacje są synchronizowane z profilem firmy i przesyłane do pliku danych. To pole jest tylko do odczytu.
affiliateLocationFeedItem

object (AffiliateLocationFeedItem)

Tylko dane wyjściowe. Rozszerzenie powiązanej lokalizacji. Lokalizacje plików danych są wypełniane przez Google Ads na podstawie identyfikatora sieci. To pole jest tylko do odczytu.
hotelCalloutFeedItem

object (HotelCalloutFeedItem)

Rozszerzenie objaśnień dotyczących hoteli.
imageFeedItem

object (ImageFeedItem)

Stałe. Reklamodawca dostarczył rozszerzenie graficzne.
Pole sumy serving_resource_targeting. Kierowanie na poziomie kampanii lub grupy reklam. Elementy pliku danych kierowane na kampanię lub grupę reklam będą wyświetlane tylko z tym zasobem. serving_resource_targeting może być tylko jedną z tych wartości:
targetedCampaign

string

Kampania kierowana.
targetedAdGroup

string

Docelowa grupa reklam.

StructuredSnippetFeedItem

Reprezentuje rozszerzenie informacji w witrynie.

Zapis JSON 
{
  "values": [
    string
  ],
  "header": string
}
Pola
values[]

string

Wartości we fragmencie. Maksymalny rozmiar tej kolekcji to 10.
header

string

Nagłówek krótkiego opisu. Ten ciąg nie może być pusty.

AppFeedItem

Reprezentuje rozszerzenie aplikacji.

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

enum (AppStore)

Magazyn aplikacji, do którego należy aplikacja docelowa. To pole jest wymagane.
finalUrls[]

string

Lista możliwych końcowych adresów URL po wszystkich przekierowaniach między domenami. Ta lista nie może być pusta.
finalMobileUrls[]

string

Lista możliwych końcowych mobilnych adresów URL po wszystkich przekierowaniach między domenami.
urlCustomParameters[]

object (CustomParameter)

Lista mapowań, które mają być używane do zastępowania tagów niestandardowych parametrów adresu URL w parametrach TrackingUrlTemplate, finalUrls lub finalMobileUrls.
linkText

string

Tekst wyświetlany podczas renderowania linku w reklamie. Ten ciąg nie może być pusty i powinien zawierać od 1 do 25 znaków.
appId

string

Identyfikator aplikacji docelowej w konkretnym sklepie. Ten ciąg nie może być pusty.
trackingUrlTemplate

string

Szablon URL do tworzenia linku monitorującego. Wartość domyślna to „{lpurl}”.
finalUrlSuffix

string

Szablon URL służący do dołączania parametrów do adresów URL stron docelowych udostępnianych ze śledzeniem równoległym.

AppStore

Typ sklepu z aplikacjami w rozszerzeniu aplikacji.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
APPLE_ITUNES Apple iTunes.
GOOGLE_PLAY Google Play.

TextMessageFeedItem

Rozszerzenie, które użytkownicy mogą kliknąć, by wysłać SMS-a do reklamodawcy.

Zapis JSON 
{
  "businessName": string,
  "countryCode": string,
  "phoneNumber": string,
  "text": string,
  "extensionText": string
}
Pola
businessName

string

Nazwa firmy, która będzie dołączana do tekstu wiadomości. To pole jest wymagane.
countryCode

string

Dwuliterowy kod kraju, pisany wielkimi literami. To pole jest wymagane.
phoneNumber

string

Numer telefonu reklamodawcy, na który zostanie wysłana wiadomość. To pole jest wymagane.
text

string

Tekst wyświetlany w reklamie. To pole jest wymagane.
extensionText

string

Tekst rozszerzenia wiadomości wypełniany w aplikacji do obsługi wiadomości.

PriceFeedItem

Reprezentuje rozszerzenie cen.

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

enum (PriceExtensionType)

Typ rozszerzenia cen tego rozszerzenia.
priceQualifier

enum (PriceExtensionPriceQualifier)

Kwalifikator ceny dla wszystkich ofert w tym rozszerzeniu cen.
priceOfferings[]

object (PriceOffer)

Ceny oferowane w tym rozszerzeniu cen.
trackingUrlTemplate

string

Szablon linku monitorującego dla wszystkich ofert w tym rozszerzeniu cen.
languageCode

string

Kod języka użytego w tym rozszerzeniu cen.
finalUrlSuffix

string

Szablon linku monitorującego dla wszystkich ofert w tym rozszerzeniu cen.

PriceOffer

Reprezentuje jedną ofertę cenową w rozszerzeniu cen.

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

object (Money)

Wartość ceny tej oferty.
unit

enum (PriceExtensionPriceUnit)

Jednostka ceny tej oferty.
finalUrls[]

string

Lista możliwych końcowych adresów URL po wszystkich przekierowaniach między domenami.
finalMobileUrls[]

string

Lista możliwych końcowych mobilnych adresów URL po wszystkich przekierowaniach między domenami.
header

string

Tekst nagłówka tej oferty.
description

string

Tekst opisu tej oferty.

PromotionFeedItem

Reprezentuje rozszerzenie promocji.

Zapis 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.
}
Pola
discountModifier

enum (PromotionExtensionDiscountModifier)

Wartość Enum, która zmienia kryteria kwalifikacji rabatu.
occasion

enum (PromotionExtensionOccasion)

Okazja, dla której była przeznaczona promocja. Jeśli masz ustawioną okazję, okres ważności musi mieścić się w powiązanym z nią zakresie dat.
finalUrls[]

string

Lista możliwych końcowych adresów URL po wszystkich przekierowaniach między domenami. To pole jest wymagane.
finalMobileUrls[]

string

Lista możliwych końcowych mobilnych adresów URL po wszystkich przekierowaniach między domenami.
urlCustomParameters[]

object (CustomParameter)

Lista mapowań, które mają być używane do zastępowania tagów niestandardowych parametrów adresu URL w parametrach TrackingUrlTemplate, finalUrls lub finalMobileUrls.
promotionTarget

string

Swobodny opis przedmiotu promocji. To pole jest wymagane.
promotionStartDate

string

Data rozpoczęcia, od której można skorzystać z promocji.
promotionEndDate

string

Data ostatniego dnia, w którym można skorzystać z promocji.
trackingUrlTemplate

string

Szablon URL do tworzenia linku monitorującego.
finalUrlSuffix

string

Szablon URL służący do dołączania parametrów do adresów URL stron docelowych udostępnianych ze śledzeniem równoległym.
languageCode

string

Język promocji. Reprezentowane jako tag języka BCP 47.
Pole sumy discount_type. Typ rabatu może przyjmować wartość procentową lub kwotową. discount_type może mieć tylko jedną z tych wartości:
percentOff

string (int64 format)

Rabat procentowy w promocji w mikro. Jeden milion to jeden procent. Wymagana jest wartość ta lub price_off_amount.
moneyAmountOff

object (Money)

Rabat kwotowy na rabat w ramach promocji. Wymagana jest ta wartość lub percentOff.
Pole sumy promotion_trigger. Reguła promocji. Można użyć kodu promocyjnego lub promocji z uwzględnieniem kwalifikującej się kwoty zamówienia. promotion_trigger może być tylko jedną z tych wartości:
promotionCode

string

Kod, który musi użyć użytkownik, aby kwalifikować się do promocji.
ordersOverAmount

object (Money)

Kwota łączna zamówienia musi być wymagana, aby użytkownik kwalifikował się do skorzystania z promocji.

LocationFeedItem

Reprezentuje rozszerzenie lokalizacji.

Zapis JSON 
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string
}
Pola
businessName

string

Nazwa firmy.
addressLine1

string

Pierwszy wiersz adresu firmy.
addressLine2

string

Drugi wiersz adresu firmy.
city

string

Miasto, w którym znajduje się adres firmy.
province

string

Region, w którym znajduje się adres firmy.
postalCode

string

Kod pocztowy adresu firmy.
countryCode

string

Kod kraju w adresie firmy.
phoneNumber

string

Numer telefonu firmy.

AffiliateLocationFeedItem

Reprezentuje rozszerzenie powiązanej lokalizacji.

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

string

Nazwa firmy.
addressLine1

string

Pierwszy wiersz adresu firmy.
addressLine2

string

Drugi wiersz adresu firmy.
city

string

Miasto, w którym znajduje się adres firmy.
province

string

Region, w którym znajduje się adres firmy.
postalCode

string

Kod pocztowy adresu firmy.
countryCode

string

Kod kraju w adresie firmy.
phoneNumber

string

Numer telefonu firmy.
chainId

string (int64 format)

Identyfikator sieci sklepów reklamowanych jako sprzedawca Twojego produktu.
chainName

string

Nazwa sieci.

HotelCalloutFeedItem

Reprezentuje rozszerzenie objaśnień dotyczących hoteli.

Zapis JSON 
{
  "text": string,
  "languageCode": string
}
Pola
text

string

Tekst objaśnienia. Jego długość powinna mieścić się w przedziale od 1 do 25 włącznie.
languageCode

string

Język tekstu objaśnienia dotyczącego hotelu. Kod języka zgodny z IETF BCP 47.

ImageFeedItem

Reprezentuje rozszerzenie graficzne dostarczone przez reklamodawcę.

Zapis JSON 
{
  "imageAsset": string
}
Pola
imageAsset

string

To pole jest wymagane. Nazwa zasobu komponentu z obrazem.