ExtensionFeedItem

Element pliku danych rozszerzenia.

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

Niezmienne. 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ących wszystkie przedziały czasowe, w których element kanału może się wyświetlać. Możesz mieć 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ę wyświetlać. 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

Godzina zakończenia, w której ten element kanału nie jest już 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 docelowej lokalizacji geograficznej.
Pole sumy extension. Typ rozszerzenia. extension może mieć 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 profilu 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 w pliku 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)

Niezmienne. Rozszerzenie graficzne dostarczone przez reklamodawcę.
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 mieć 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 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 z przekierowaniami między domenami. Ta lista nie może być pusta.
finalMobileUrls[]

string

Lista możliwych końcowych adresów URL dla urządzeń mobilnych 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 widoczny podczas renderowania linku w reklamie. Ten ciąg nie może być pusty, a długość powinien mieścić się w zakresie od 1 do 25 włącznie.
appId

string

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

string

Szablon adresu URL służący 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 wyświetlanych przy użyciu śledzenia równoległego.

AppStore

Typ sklepu z aplikacjami w rozszerzeniu aplikacji.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
APPLE_ITUNES Apple iTunes.
GOOGLE_PLAY Google Play.

TextMessageFeedItem

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

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

string

Nazwa firmy, która będzie widoczna na początku tekstu wiadomości. To pole jest wymagane.
countryCode

string

Dwuliterowy kod kraju, w którym znajduje się numer telefonu reklamodawcy, 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

Rozszerzenie wiadomości wypełniane 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 cen dla wszystkich ofert w tym rozszerzeniu cen.
priceOfferings[]

object (PriceOffer)

Oferty cenowe 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 z przekierowaniami między domenami.
finalMobileUrls[]

string

Lista możliwych końcowych adresów URL dla urządzeń mobilnych 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ść, która zmienia kryteria kwalifikacji rabatu.
occasion

enum (PromotionExtensionOccasion)

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

string

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

string

Lista możliwych końcowych adresów URL dla urządzeń mobilnych 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 tematyki promocji. To pole jest wymagane.
promotionStartDate

string

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

string

Ostatni dzień, w którym można skorzystać z promocji.
trackingUrlTemplate

string

Szablon adresu URL służący do tworzenia linku monitorującego.
finalUrlSuffix

string

Szablon URL służący do dołączania parametrów do adresów URL stron docelowych wyświetlanych przy użyciu śledzenia równoległego.
languageCode

string

Język promocji. Reprezentowany jako tag języka BCP 47.
Pole sumy discount_type. Typ rabatu: może to być rabat procentowy lub kwotowy. 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 promocji. Wymagana jest ta wartość lub parametr percentOff.
Pole sumy promotion_trigger. Wyzwalacz promocji. Można podać przy użyciu kodu promocyjnego lub kwoty promocyjnej według kwalifikującej się kwoty zamówienia. promotion_trigger może mieć tylko jedną z tych wartości:
promotionCode

string

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

object (Money)

Kwota musi być równa łącznej kwocie zamówienia, aby użytkownik mógł skorzystać 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

Prowincja adresu 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

Prowincja adresu 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. Długość tego ciągu 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 ze standardem 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.