ExtensionFeedItem

Element kanału 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

Stały. Nazwa zasobu elementu kanału rozszerzenia. Nazwy zasobów elementów kanału rozszerzeń 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 niepokrywających się harmonogramów określających wszystkie przedziały czasu, w których element kanału może wyświetlać reklamy. 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 RSS. 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 działa i może zacząć wyświetlać reklamy. Godzina jest podana w strefie czasowej klienta. Użyj formatu „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 przestał działać i przestanie się wyświetlać. Godzina jest podana w strefie czasowej klienta. Użyj formatu „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 wartość kierowania geograficznego.

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 w 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 hotelu.

imageFeedItem

object (ImageFeedItem)

Stały. Rozszerzenie graficzne przesłane przez reklamodawcę.

Pole sumy serving_resource_targeting. Kierowanie na poziomie kampanii lub grupy reklam. Elementy kanału 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 docelowa.

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 fragmentu kodu. 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 adresów URL dla urządzeń mobilnych po wszystkich przekierowaniach między domenami.

urlCustomParameters[]

object (CustomParameter)

Lista mapowań, które mogą być używane do zastępowania tagów niestandardowych parametrów adresów URL w szablonie trackingUrlTemplate, finalUrls lub finalMobileUrls.

appId

string

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

trackingUrlTemplate

string

Szablon 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 obsługiwanych przez śledzenie równoległe.

AppStore

Typ sklepu z aplikacjami w rozszerzeniu aplikacji.

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

TextMessageFeedItem

Rozszerzenie, które użytkownik może 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 ma zostać dodana do tekstu wiadomości. To pole jest wymagane.

countryCode

string

Dwuliterowy kod kraju numeru telefonu reklamodawcy zapisany wielkimi literami. To pole jest wymagane.

phoneNumber

string

Numer telefonu reklamodawcy, na który zostanie wysłana wiadomość. Wymagane.

text

string

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

extensionText

string

Tekst rozszerzenia wiadomości wpisany 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 w tym rozszerzeniu cen.

trackingUrlTemplate

string

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

languageCode

string

Kod języka używanego 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 dla 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 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ść wyliczeniowa modyfikująca kwalifikację rabatu.

occasion

enum (PromotionExtensionOccasion)

Okazja, na którą miała być kierowana promocja. Jeśli masz ustawioną okazję, okres wykorzystania musi mieścić się w zakresie dat powiązanym z tą okazji.

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 adresów URL dla urządzeń mobilnych po wszystkich przekierowaniach między domenami.

urlCustomParameters[]

object (CustomParameter)

Lista mapowań, które mogą być używane do zastępowania tagów niestandardowych parametrów adresów URL w szablonie trackingUrlTemplate, finalUrls lub finalMobileUrls.

promotionTarget

string

Dowolny opis celu promocji. To pole jest wymagane.

promotionStartDate

string

Data rozpoczęcia możliwości skorzystania z promocji.

promotionEndDate

string

Dzień, w którym można skorzystać z promocji.

trackingUrlTemplate

string

Szablon 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 obsługiwanych przez śledzenie równoległe.

languageCode

string

Język promocji. Widoczny 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 milionowych częściach jednostki. Jeden milion to jeden procent. Wymagane jest podanie tej wartości lub kwoty Money_off_amount.

moneyAmountOff

object (Money)

Kwota rabatu kwotowego rabatu w ramach promocji. Wymagane jest określenie tej wartości lub wartości procentowej.

Pole sumy promotion_trigger. Aktywator promocji. Może to być kod promocyjny lub promocja związana z kwalifikującą się kwotą zamówienia. promotion_trigger może mieć tylko jedną z tych wartości:
promotionCode

string

Kod, którego musi użyć użytkownik, aby kwalifikować się do skorzystania z promocji.

ordersOverAmount

object (Money)

Kwota, jaką musi osiągnąć użytkownik, aby kwalifikować się do 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

Wiersz 1 adresu firmy.

addressLine2

string

Wiersz 2 adresu firmy.

city

string

Miasto w adresie 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

Wiersz 1 adresu firmy.

addressLine2

string

Wiersz 2 adresu firmy.

city

string

Miasto w adresie 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 wynosić 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

Wymagane. Nazwa zasobu komponentu z obrazem.