Omówienie interfejsu Merchant Data Source API

Na tej stronie dowiesz się, jak programowo tworzyć i aktualizować źródła danych, które umożliwiają wstawianie produktów. Automatyczne źródła danych ułatwiają przesyłanie danych produktów do Google. Automatyczne źródła danych dbają o to, aby Google otrzymywało najbardziej aktualne informacje o odpowiednich produktach z Twojej witryny.

Content API for Shopping umożliwia tworzenie tylko podstawowych źródeł danych. Za pomocą interfejsu Merchant Data sources API możesz tworzyć te typy źródeł danych:

Interfejs Content API for Shopping umożliwia zarządzanie źródłami danych tylko za pomocą plików wejściowych. Interfejs Merchant API umożliwia zarządzanie źródłami danych za pomocą plików i danych wejściowych interfejsu API.

Za pomocą interfejsu Merchant Data sources API możesz:

  • Utwórz nowe podstawowe źródło danych z określonym feedLabel i contentLanguage.
  • Utwórz źródło danych, które nie ma ustawionych pól feedLabel i contentLanguage. Za pomocą tego typu źródła danych możesz kierować swoje produkty na wiele krajów, ponieważ możesz wstawiać produkty z różnymi kombinacjami feedLabel i contentLanguage do jednego źródła danych.
  • Utwórz dodatkowe źródło danych, aby połączyć je z dotychczasowym podstawowym źródłem danych.
  • Skonfiguruj harmonogram dla źródła danych pliku.
  • Zarejestruj swoje konto, aby automatycznie zarządzać źródłami danych.
  • Zarządzaj źródłami danych interfejsu API.
  • Zarządzaj domyślną regułą źródeł danych za pomocą podstawowych źródeł danych o produktach.
  • Używanie innych typów źródeł danych, np. promocji.

Nie możesz używać interfejsu Merchant API do wstawiania produktów w źródle danych, które zawiera zarówno produkty dostępne lokalnie, jak i online. Więcej informacji o kanałach źródeł danych znajdziesz w artykule Kanały.

Wymagania wstępne

  • Twoje konto musi zostać przeniesione do plików danych w jednym języku.

  • Aby sprawdzić, czy konto zostało już przeniesione do podziału na docelowe dane, użyj listy źródeł danych lub metod get. Jeśli nie kwalifikujesz się do udziału w programie, otrzymasz następujący komunikat o wyjątku i musisz skontaktować się z zespołem pomocy.

    This account is in the data sources migration process and can't be used with
this API yet. Contact support for more info on when this account will be able
to use the data sources endpoint.

Tworzenie nowego źródła danych

Podstawowe źródła danych to główne źródła danych o asortymencie produktów w Merchant Center. Produkty możesz dodawać i usuwać tylko za pomocą podstawowego źródła danych. Jeśli każdy produkt dodany do podstawowego źródła danych spełnia wymagania Merchant Center dotyczące danych i wyświetlania, nie musisz tworzyć kolejnych źródeł danych.

Aby utworzyć nowe podstawowe źródło danych z określonym feedLabel i contentLanguage, skonfiguruj pola feedLabel i contentLanguage w ramach konfiguracji odpowiedniej dla typu. Więcej informacji o tych polach znajdziesz w artykule PrimaryProductDataSource.

Poniższy przykładowy żądanie pokazuje, jak utworzyć podstawowe źródło danych o produktach:

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources

{
  "displayName": "{DISPLAY_NAME}",
  "primaryProductDataSource": {
    "contentLanguage": "{CONTENT_LANGUAGE}",
    "feedLabel": "{FEED_LABEL}",
    "countries": [
      "{COUNTRY}"
    ],
    "channel": "ONLINE_PRODUCTS"
  }
}

Zastąp następujące elementy:

  • {ACCOUNT_ID}: unikalny identyfikator Twojego konta Merchant Center.
  • {DISPLAY_NAME}: wyświetlana nazwa źródła danych.
  • {CONTENT_LANGUAGE}: dwuliterowy kod języka ISO 639-1 produktów w źródle danych.
  • {FEED_LABEL}: etykieta pliku danych źródła danych.
  • {COUNTRY}: kod regionu CLDR kraju docelowego produktów, które zostaną przesłane za pomocą źródła danych.

Po pomyślnym wykonaniu żądania pojawi się taka odpowiedź:

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATA_SOURCE_ID}",
  "dataSourceId": "{DATA_SOURCE_ID}",
  "displayName": "{DISPLAY_NAME}",
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "feedLabel": "{FEED_LABEL}",
    "contentLanguage": "{CONTENT_LANGUAGE}",
    "countries": [
      "{COUNTRY}"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

Więcej informacji o tworzeniu źródła danych znajdziesz w metodzie accounts.dataSources.create.

Aby wyświetlić nowo utworzone źródło danych, użyj metody accounts.dataSources.get lub accounts.dataSources.list.

Tworzenie nowego podstawowego źródła danych, które ułatwia kierowanie reklam na wiele krajów

Aby utworzyć nowy podstawowy plik danych, który pomoże Ci kierować reklamy na wiele krajów, skonfiguruj źródło danych za pomocą pola PrimaryProductDataSource i nie ustawiaj pól feedLabel ani contentLanguage.

W przypadku Content API for Shopping jest tworzone tylko jedno źródło danych API. Za pomocą interfejsu API źródeł danych o sprzedawcach możesz mieć wiele źródeł danych API, z których niektóre mogą nie mieć ustawionych pól feedLabel i contentLanguage.

Pola feedLabel i contentLanguage mogą być puste tylko w przypadku źródeł danych z danymi wejściowymi z interfejsu API. Ten typ źródeł danych nie jest obsługiwany w przypadku danych wejściowych typu plik.

Tworzenie dodatkowego źródła danych i połączenie go z podstawowym źródłem danych

Dodatkowe źródła danych służą wyłącznie do aktualizowania danych produktów, które znajdują się już w co najmniej jednym podstawowym źródle danych. Możesz mieć wiele dodatkowych źródeł danych, a każde z nich może zawierać dane uzupełniające dowolną liczbę podstawowych źródeł danych.

Za pomocą dodatkowych źródeł danych możesz wprowadzać częściowe zmiany w danych produktów, dodając niepowtarzalny identyfikator źródła danych jako parametr zapytania podczas wywoływania metod accounts.productInputs.insert i accounts.productInputs.delete. Źródeł danych uzupełniających możesz używać tylko do aktualizowania istniejących produktów.

Aby utworzyć dodatkowe źródło danych, skonfiguruj źródło danych za pomocą opcji SupplementalProductDataSource, a następnie połącz je, aktualizując pole defaultRule w podstawowym źródle danych.

W przypadku dodatkowych źródeł danych plików musisz ustawić pola feedLabel i contentLanguage. W przypadku dodatkowych źródeł danych interfejsu API pola feedLabel i contentLanguage muszą być zawsze puste.

Konfigurowanie harmonogramu dla źródła danych o plikach

Aby skonfigurować harmonogram dla pliku danych, skonfiguruj źródło danych jako źródło danych pliku za pomocą pola FileInput, a następnie skonfiguruj fetchsettings za pomocą pola FileInput.FetchSettings.

Usuwanie źródła danych

Aby usunąć z konta dotychczasowe źródło danych, użyj metody accounts.dataSources.delete.

Pobieranie źródła danych

Aby pobrać plik skonfigurowany w źródle danych, użyj metody accounts.dataSources.fetch. Ta metoda umożliwia natychmiastowe pobieranie danych ze źródła danych na Twoim koncie. Ta metoda działa tylko w przypadku źródeł danych z ustawionym wejściem z pliku.

Pobieranie źródła danych

Aby pobrać konfigurację źródła danych na swoim koncie, użyj metody accounts.dataSources.get.

Wyświetlanie listy źródeł danych

Aby wyświetlić listę konfiguracji źródeł danych na swoim koncie, użyj metody accounts.dataSources.list.

Źródło danych poprawki

Aby zaktualizować konfigurację dotychczasowego źródła danych, użyj metody accounts.dataSources.patch.

Główne źródła danych o produktach umożliwiają zarządzanie domyślną regułą źródeł danych. Reguła domyślna to reguła, która jest stosowana do wszystkich atrybutów w źródle danych. Regułę domyślną możesz ustawić podczas tworzenia źródła danych lub zaktualizować istniejące źródło danych za pomocą pola reguły domyślnej.

Więcej informacji o konfigurowaniu reguł znajdziesz w artykule Konfigurowanie reguł źródeł danych o produktach.

Poniżej znajduje się przykładowa konfiguracja, która zapewnia, że wszystkie atrybuty są pobierane najpierw ze źródła danych o wyjątkowym identyfikatorze 1001. Następnie brakujące atrybuty są dodawane z podstawowego źródła danych. Pozostałe atrybuty zostaną ostatecznie pobrane ze źródła danych uzupełniających za pomocą unikalnego identyfikatora 1002, o ile nie zostały jeszcze podane w żadnym innym źródle danych. Jeśli ten sam atrybut jest podany w kilku źródłach danych, wybrana jest wartość znajdująca się wyżej na liście.

defaultRule {
 takeFromDataSources: [
   '1001', // Supplemental product data source
   'self', //  Self reference to the primary data source
   '1002' // Supplemental product data source
 ]
}

Automatyczne zarządzanie plikami danych

Aby zarejestrować konto na potrzeby automatycznego zarządzania źródłami danych:

Gdy Twoje konto spełnia wymagania dotyczące rejestracji, możesz użyć metody accounts.autofeedSettings.updateAutofeedSettings, aby włączyć automatyczne zarządzanie źródłami danych. Włączenie automatycznego zarządzania źródłami danych pozwala Google automatycznie dodawać produkty ze sklepu internetowego i dbać o to, aby były zawsze aktualne na platformach Google.

Pobieranie stanu przesyłania pliku

Aby uzyskać stan źródła danych z pliku, funkcji pobierania lub arkusza kalkulacyjnego, możesz wywołać metodę GET usługi accounts.dataSources.fileUploads. Aby uzyskać wynik ostatniego wyszukiwania źródła danych obliczonego asynchronicznie po zakończeniu przetwarzania, użyj nazwy identyfikator latest.

GET https://merchantapi.googleapis.com/accounts/v1beta/{ACCOUNT_ID}/datasources/{DATASOURCE_ID}/fileUploads/latest

Stan przesyłania pliku może zawierać szczegółowy widok Twoich produktów, w tym ewentualne problemy.

Pamiętaj, że stan przesyłania pliku może nie być widoczny, jeśli plik nie został przesłany. Jeśli prośba została wysłana wkrótce po przesłaniu pliku, jego stan może być „w trakcie przetwarzania”.