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

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

customers/{customerId}/feeds/{feedId}
attributes[]

object (FeedAttribute)

Atrybuty pliku danych. Wymagane w przypadku metody CREATE, chyba że podasz system_feed_generation_data. W takim przypadku Google Ads zaktualizuje plik danych, podając prawidłowe atrybuty. Niedozwolone w dniu UPDATE. Aby dodać nowe atrybuty, użyj atrybutu atrybutówOperations.
attributeOperations[]

object (FeedAttributeOperation)

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

enum (FeedOrigin)

Stałe. Określa, kto zarządza atrybutami pliku danych.
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

Stałe. Nazwa pliku danych. To pole jest wymagane.
Pole sumy system_feed_generation_data. Dane systemowe pliku danych. Te dane określają informacje służące do generowania pozycji pliku danych wygenerowanego przez system. system_feed_generation_data może być 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 o powiązanych lokalizacjach zawierającego określone sieci.

FeedAttribute

Atrybuty FeedAttributes określają, jakie typy danych powinny się znaleźć w pliku danych. Pojedynczy atrybut FeedAttribute określa oczekiwany typ atrybutów FeedItemAttributes z tym samym identyfikatorem FeedAttributeId. Opcjonalnie atrybut kanału można oznaczyć 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, ma domyślnie wartość Fałsz. Pamiętaj, że w schemacie pliku danych nie jest wymagany unikalny klucz. W takim przypadku do elementów FeedItems trzeba się odwoływać za pomocą atrybutu „feed_item_id”.

FeedAttributeType

Możliwe typy danych w atrybucie pliku danych.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
INT64 Int64.
DOUBLE Podwójna.
STRING Ciąg tekstowy.
BOOLEAN Wartość logiczna.
URL 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 daty i godziny.
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

Operatora.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. 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 Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
USER Atrybutymi pliku danych w tym pliku danych zarządza użytkownik. Użytkownicy mogą dodawać atrybuty do tego pliku danych.
GOOGLE Atrybuty kanału GOOGLE są tworzone przez Google. Plik danych tego typu jest utrzymywany przez Google i będzie zawierał 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 Używana tylko w przypadku wartości zwracanej. 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)

Stałe. Wymagany token uwierzytelniania (z interfejsu OAuth API) dla e-maila. To pole można określić tylko w żądaniu utworzenia. Nie można wybrać żadnych 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 dostępne dla użytkownika (określone za pomocą adresu e-mail). To pole jest tylko do wprowadzenia mutacji i nie można go wybrać.
categoryFilters[]

string

Służy do filtrowania wizytówek firm w Profilu Firmy według kategorii. Jeśli wpisy istnieją w filtrze kategorii, do synchronizacji z elementami kanału kwalifikują się tylko wpisy należące do dowolnej z kategorii. 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 firm w Profilu Firmy według etykiet. Jeśli wpisy istnieją w filtrze etykiet, do synchronizacji z elementami kanału nadają się tylko listy, które mają ustawioną dowolną z etykiet. Jeśli w filtrach etykiet nie ma żadnych wpisów, wszystkie strony aplikacji nadają 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 nadają się 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 o powiązanych lokalizacjach zawierającego określone sieci.

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

string (int64 format)

Lista sieci, z których plik danych o powiązanych lokalizacjach 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 Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
GENERAL_RETAILER Współpraca ze sprzedawcą detalicznym.