Feed

Plik danych.

Zapis JSON
{
  "resourceName": string,
  "attributes": [
    {
      object (FeedAttribute)
    }
  ],
  "attributeOperations": [
    {
      object (FeedAttributeOperation)
    }
  ],
  "origin": enum (FeedOrigin),
  "status": enum (FeedStatus),
  "id": string,
  "name": string,

  // Union field system_feed_generation_data can be only one of the following:
  "placesLocationFeedData": {
    object (PlacesLocationFeedData)
  },
  "affiliateLocationFeedData": {
    object (AffiliateLocationFeedData)
  }
  // End of list of possible types for union field system_feed_generation_data.
}
Pola
resourceName

string

Niezmienne. Nazwa zasobu pliku danych. Nazwy zasobów kanału mają postać:

customers/{customerId}/feeds/{feedId}

attributes[]

object (FeedAttribute)

Atrybuty pliku danych. Wymagana podczas tworzenia pliku danych CREATE, chyba że podasz system_feed_generation_data. W takim przypadku Google Ads zaktualizuje plik danych, używając prawidłowych atrybutów. Niedozwolone w dniu UPDATE. Aby dodać nowe atrybuty, użyj atrybutu attributeOperations.

attributeOperations[]

object (FeedAttributeOperation)

Lista operacji zmieniających atrybuty pliku danych. Atrybuty można tylko dodawać, a nie usuwać.

origin

enum (FeedOrigin)

Niezmienne. Określa, kto zarządza atrybutami kanałów.

status

enum (FeedStatus)

Tylko dane wyjściowe. Stan pliku danych. To pole jest tylko do odczytu.

id

string (int64 format)

Tylko dane wyjściowe. Identyfikator pliku danych. To pole jest tylko do odczytu.

name

string

Niezmienne. Nazwa pliku danych. To pole jest wymagane.

Pole sumy system_feed_generation_data. Dane systemowe dotyczące pliku danych. Te dane określają informacje służące do generowania elementów kanału wygenerowanego przez system. system_feed_generation_data może mieć tylko jedną z tych wartości:
placesLocationFeedData

object (PlacesLocationFeedData)

Dane używane do konfigurowania pliku danych z lokalizacjami uzupełnianego z Profilu Firmy.

affiliateLocationFeedData

object (AffiliateLocationFeedData)

Dane używane do konfigurowania pliku danych z powiązaną lokalizacją, który jest wypełniany określonymi sieciami.

FeedAttribute

Atrybuty FeedAttributes określają typy danych, które powinny się znaleźć w kanale. Pojedynczy atrybut FeedAttribute określa oczekiwany typ atrybutów FeedItemAttributes z tym samym identyfikatorem FeedAttributeId. Opcjonalnie atrybut FeedAttribute może być oznaczony jako część unikalnego klucza elementu kanału.

Zapis JSON
{
  "type": enum (FeedAttributeType),
  "id": string,
  "name": string,
  "isPartOfKey": boolean
}
Pola
type

enum (FeedAttributeType)

Typ danych dla atrybutu pliku danych. To pole jest wymagane.

id

string (int64 format)

Identyfikator atrybutu.

name

string

Nazwa atrybutu. To pole jest wymagane.

isPartOfKey

boolean

Wskazuje, że dane odpowiadające temu atrybutowi są częścią unikalnego klucza elementu kanału. Jeśli nie jest określony, przyjmuje domyślnie wartość fałsz. Pamiętaj, że w schemacie pliku danych nie jest wymagany unikalny klucz. W takim przypadku element FeedItems musi być odwołany przez parametr „feed_item_id”.

FeedAttributeType

Możliwe typy danych dla atrybutu pliku danych.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
INT64 Int64.
DOUBLE Liczba zmiennoprzecinkowa:
STRING Ciąg tekstowy.
BOOLEAN Wartość logiczna.
URL Adres URL.
DATE_TIME Data i godzina.
INT64_LIST Lista Int64.
DOUBLE_LIST Lista podwójna (8 bajtów).
STRING_LIST Lista ciągów znaków.
BOOLEAN_LIST Lista wartości logicznych.
URL_LIST Lista adresów URL.
DATE_TIME_LIST Lista dat i godzin.
PRICE Cena.

FeedAttributeOperation

Operacja do wykonania na liście atrybutów w mutacji.

Zapis JSON
{
  "operator": enum (Operator),
  "value": {
    object (FeedAttribute)
  }
}
Pola
operator

enum (Operator)

Tylko dane wyjściowe. Typ operacji na liście do wykonania.

value

object (FeedAttribute)

Tylko dane wyjściowe. Atrybut pliku danych dodawany do listy.

Operator

Operator.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
ADD Dodaj atrybut do istniejących atrybutów.

FeedOrigin

Możliwe wartości źródła kanału.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
USER Atrybutymi kanałów tego pliku danych zarządza użytkownik. Użytkownicy mogą dodawać atrybuty kanału do tego pliku danych.
GOOGLE Atrybuty plików danych dla kanału GOOGLE są tworzone przez Google. Plik danych tego typu jest utrzymywany przez Google i będzie miał prawidłowe atrybuty dla typu symbolu zastępczego w pliku danych.

FeedStatus

Możliwe stany pliku danych.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
ENABLED Plik danych jest włączony.
REMOVED Kanał został usunięty.

PlacesLocationFeedData

Dane używane do konfigurowania pliku danych z lokalizacjami uzupełnianego z Profilu Firmy.

Zapis JSON
{
  "oauthInfo": {
    object (OAuthInfo)
  },
  "businessAccountId": string,
  "categoryFilters": [
    string
  ],
  "labelFilters": [
    string
  ],
  "emailAddress": string,
  "businessNameFilter": string
}
Pola
oauthInfo

object (OAuthInfo)

Niezmienne. Wymagany token uwierzytelniania (z interfejsu OAuth API) dla e-maila. To pole można określić tylko w żądaniu utworzenia. Nie można wybrać jego pól podrzędnych.

businessAccountId

string

Identyfikator strony plus zarządzanej firmy, której lokalizacje mają zostać użyte. Jeśli to pole nie jest skonfigurowane, używane są wszystkie firmy, do których użytkownik ma dostęp (określone za pomocą adresu e-mail). To pole jest tylko do mutacji i nie można go wybrać.

categoryFilters[]

string

Służy do filtrowania wizytówek w Profilu Firmy według kategorii. Jeśli w filtrze kategorii znajdują się wpisy, tylko listy, które należą do dowolnej z kategorii, są kandydatami do zsynchronizowania z elementami kanału. Jeśli w filtrach kategorii nie ma żadnych wpisów, wszystkie strony aplikacji nadają się do zsynchronizowania.

labelFilters[]

string

Służy do filtrowania wizytówek w Profilu Firmy według etykiet. Jeśli wpisy znajdują się w ramach filtrów etykiet, do synchronizacji z elementami kanału RSS nadają się tylko listy zawierające dowolną z etykiet. Jeśli w etykietach etykiet nie ma żadnych wpisów, wszystkie listy kwalifikują się do zsynchronizowania.

emailAddress

string

Adres e-mail profilu firmy lub adres e-mail menedżera profilu firmy. To pole jest wymagane.

businessNameFilter

string

Służy do filtrowania wizytówek w Profilu Firmy według nazwy firmy. Jeśli jest ustawiony filtr businessNameFilter, do synchronizacji z elementami kanału kandydują tylko wizytówki z pasującą nazwą firmy.

OAuthInfo

Dane używane do autoryzacji przy użyciu protokołu OAuth.

Zapis JSON
{
  "httpMethod": string,
  "httpRequestUrl": string,
  "httpAuthorizationHeader": string
}
Pola
httpMethod

string

Metoda HTTP używana do uzyskania autoryzacji.

httpRequestUrl

string

Adres URL żądania HTTP używany do uzyskania autoryzacji.

httpAuthorizationHeader

string

Nagłówek autoryzacji HTTP używany do uzyskania autoryzacji.

AffiliateLocationFeedData

Dane używane do konfigurowania pliku danych z powiązaną lokalizacją, który jest wypełniany określonymi sieciami.

Zapis JSON
{
  "chainIds": [
    string
  ],
  "relationshipType": enum (AffiliateLocationFeedRelationshipType)
}
Pola
chainIds[]

string (int64 format)

Lista sieci, z których plik danych powiązanej lokalizacji będzie synchronizować lokalizacje.

relationshipType

enum (AffiliateLocationFeedRelationshipType)

Relacja sieci z reklamodawcą.

AffiliateLocationFeedRelationshipType

Możliwe wartości typu relacji w pliku danych z powiązaną lokalizacją.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
GENERAL_RETAILER Relacja ze sprzedawcą detalicznym.