Przyrostowe aktualizacje zasobów reklamowych (wersja 1)

W tej sekcji opisujemy, jak wysyłać do Google ograniczone czasowo aktualizacje kanałów. Interfejs Incremental Updates API pozwala aktualizować i usuwać encje w kanałach w czasie zbliżonym do rzeczywistego.

Uwaga: musisz dodać tę funkcję do akcji, chyba że masz do niej dostęp. Jeśli nie wiesz, czy musisz wdrożyć aktualizacje asortymentu, skontaktuj się ze swoim konsultantem Google.

Ta funkcja jest przeznaczona przede wszystkim w przypadku aktualizacji, których nie możesz przewidzieć, takich jak zamknięcia awaryjne. Z reguły wszelkie zmiany przesyłane za pomocą interfejsu przyrostowego interfejsu API powinny zostać wprowadzone w ciągu maksymalnie tygodnia. Jeśli zmiana nie musi być widoczna od razu, możesz użyć aktualizacji zbiorczej. Aktualizacje przyrostowe są przetwarzane nie dłużej niż 5 minut.

Konfiguracja

Aby wdrożyć aktualizacje przyrostowe, wykonaj te czynności:

1. Aby utworzyć projekt, wykonaj czynności opisane w artykule Tworzenie i konfigurowanie projektu.
2. Aby utworzyć konto usługi, wykonaj czynności opisane w artykule Konfigurowanie konta usługi. Pamiętaj, że aby dodać do konta usługi rolę „Edytujący”, musisz być „Właścicielem” projektu.
3. (Opcjonalne, ale zalecane) Zainstaluj bibliotekę klienta Google w wybranym języku, aby ułatwić korzystanie z protokołu OAuth 2.0 podczas wywoływania interfejsu API. Przykładowe fragmenty kodu znajdujące się poniżej korzystają z tych bibliotek. W przeciwnym razie konieczna będzie ręczna obsługa wymiany tokenów zgodnie z opisem w artykule Uzyskiwanie dostępu do interfejsów API Google za pomocą OAuth 2.0.

Punkt końcowy

Aby powiadomić Google o aktualizacji, wyślij żądanie HTTP POST do interfejsu Incremental Updates API i dołącz ładunek z aktualizacjami i dodatkami. Używany schemat asortymentu określa, do którego punktu końcowego ma zostać wysłane żądanie:

Zasoby reklamowe w wersji 2

https://actions.googleapis.com/v2/apps/PROJECT_ID/entities/TYPE/ENTITY_ID:push

Zasoby reklamowe w wersji 1

https://actions.googleapis.com/v2/apps/PROJECT_ID/entities/ENTITY_ID:push

Aby usunąć encję, wyślij żądanie HTTP DELETE do tego punktu końcowego odpowiadającego używanemu schematowi zasobów reklamowych:

Zasoby reklamowe w wersji 2

https://actions.googleapis.com/v2/apps/PROJECT_ID/entities/TYPE/ENTITY_ID?entity.vertical=FOODORDERING&delete_time=DELETE_TIME

Zasoby reklamowe w wersji 1

https://actions.googleapis.com/v2/apps/PROJECT_ID/entities/ENTITY_ID?entity.vertical=FOODORDERING&delete_time=DELETE_TIME

W powyższych prośbach zastąp te elementy:

• PROJECT_ID: identyfikator projektu Google Cloud powiązany z projektem utworzonym w sekcji Tworzenie i konfigurowanie projektu.
• TYPE (tylko schemat zasobów reklamowych w wersji 2): typ elementu (właściwość @type) obiektu w pliku danych, który chcesz zaktualizować.
• ENTITY_ID: identyfikator elementu uwzględnionego w ładunku. Pamiętaj, aby w adresie URL zakodować identyfikator jednostki.
• DELETE_TIME (tylko usunięcie punktu końcowego): pole opcjonalne na oznaczenie czasu usunięcia elementu w Twoich systemach (domyślnie jest to pole w momencie odebrania żądania). Wartość czasu nie może przypadać w przyszłości. Gdy wysyłasz encję za pomocą wywołania przyrostowego, obsługa wersji encji też używa pola delete_time w przypadku wywołania usuwania. Sformatuj tę wartość jako yyyy-mm-ddTHH:mm:ssZ

Załóżmy na przykład, że masz projekt o identyfikatorze „delivery-provider-id”, który korzysta ze schematu zasobów reklamowych w wersji 2. Chcesz wprowadzić zmiany w restauracji, której typ elementu to „MenuSection” i identyfikator elementu „menuSection_122”. Punkt końcowy aktualizacji danych będzie wyglądał tak:

https://actions.googleapis.com/v2/apps/delivery-provider-id/entities/MenuSection/menuSection_122:push

Aby usunąć tę samą encję, musisz wykonać to wywołanie interfejsu API HTTP DELETE:

https://actions.googleapis.com/v2/apps/delivery-provider-id/entities/MenuSection/menuSection_122?entity.vertical=FOODORDERING

Prośby dotyczące piaskownicy

W przypadku żądań piaskownicy postępuj zgodnie ze wskazówkami podanymi powyżej w sekcji Punkt końcowy, ale wysyłaj żądania do /v2/sandbox/apps/ zamiast do /v2/apps/. Na przykład żądanie usunięcia w trybie piaskownicy dotyczące schematu zasobów reklamowych w wersji 2 ma taką strukturę:

https://actions.googleapis.com/v2/sandbox/apps/PROJECT_ID/entities/TYPE/ENTITY_ID?entity.vertical=FOODORDERING&delete_time=DELETE_TIME

Aktualizacje i dodatki

Codzienne pliki danych powinny zawierać wszelkie zmiany przesyłane za pomocą tego interfejsu API. W przeciwnym razie aktualizacje zbiorcze zastąpią zmiany przyrostowe.

Ładunek

Każde żądanie POST musi zawierać parametry żądania wraz z ładunkiem JSON zawierającym uporządkowane dane dowolnego typu encji wymienionego w schemacie zasobów.

Plik JSON powinien wyglądać tak samo jak w pliku danych wsadowym, z tymi różnicami:

• Rozmiar treści ładunku nie powinien przekraczać 5 MB. Podobnie jak w przypadku plików danych wsadowych zalecamy usuwanie odstępów, aby można było dopasować więcej danych.
• Oto jak wygląda koperta:

{
  "entity": {
    "data":"ENTITY_DATA",
    "vertical":"FOODORDERING"
  },
  "update_time":"UPDATE_TIMESTAMP"
}

W powyższym ładunku zastąp to:

• ENTITY_DATA: encja w formacie JSON zserializowana jako ciąg znaków. Encja JSON-LD musi zostać przekazana jako ciąg znaków w polu data.
• UPDATE_TIMESTAMP (opcjonalnie): sygnatura czasowa aktualizacji elementu w Twoich systemach. Wartość czasu nie może przypadać w przyszłości. Domyślna sygnatura czasowa to moment otrzymania żądania przez Google. Gdy wysyłasz encję za pomocą żądania przyrostowego, obsługa wersji encji też używa pola update_time w przypadku żądania dodania/aktualizacji.

Uwaga: jeśli używasz schematu zasobów reklamowych w wersji 1, musisz wysłać cały element najwyższego poziomu, nawet jeśli chcesz zaktualizować tylko część elementu najwyższego poziomu (np. cenę pozycji w menu). Identyfikator jednostki najwyższego poziomu jest częścią adresu URL żądania POST i nie jest częścią ładunku JSON-LD żądania.

Aktualizowanie elementu

Przykład 1. Aktualizowanie informacji o restauracji

Załóżmy, że musisz pilnie zaktualizować numer telefonu do restauracji. Twoja aktualizacja zawiera plik JSON dla całej restauracji.

Przyjrzyjmy się zbiorczemu plikowi danych podobnemu do tego:

{
  "@type": "Restaurant",
  "@id": "restaurant12345",
  "name": "Some Restaurant",
  "url": "https://www.provider.com/somerestaurant",
  "telephone": "[phone]",
  "streetAddress": "345 Spear St",
  "addressLocality": "San Francisco",
  "addressRegion": "CA",
  "postalCode": "94105",
  "addressCountry": "US",
  "latitude": 37.472842,
  "longitude": -122.217144
}

Przyrostowa aktualizacja za pomocą metody POST w protokole HTTP będzie wyglądać tak:

POST v2/apps/provider-project/entities/Restaurant/restaurant12345:push
Host: actions.googleapis.com
Content-Type: application/ld+json
{
  "entity": {
    "data": {
      "@type": "Restaurant",
      "@id": "restaurant12345",
      "name": "Some Restaurant",
      "url": "https://www.provider.com/somerestaurant",
      "telephone": "[phone]",
      "streetAddress": "345 Spear St",
      "addressLocality": "San Francisco",
      "addressRegion": "CA",
      "postalCode": "94105",
      "addressCountry": "US",
      "latitude": 37.472842,
      "longitude": -122.217144
    },
    "vertical": "FOODORDERING"
  }
}

Uwaga: w powyższym przykładzie „dane” nie są zserializowane jako ciąg znaków umożliwiający czytelność.

Przykład 2. Aktualizowanie ceny pozycji w menu

Załóżmy, że chcesz zmienić cenę pozycji w menu. Tak jak w przykładzie 1, aktualizacja musi zawierać plik JSON dotyczący całego elementu najwyższego poziomu (menu), a plik danych korzysta ze schematu zasobów reklamowych w wersji 1.

Przyjrzyjmy się zbiorczemu plikowi danych podobnemu do tego:

{
  "@type": "MenuItemOffer",
  "@id": "menuitemoffer6680262",
  "sku": "offer-cola",
  "menuItemId": "menuitem896532",
  "price": 3.00,
  "priceCurrency": "USD"
}

Przyrostowa aktualizacja metodą POST będzie wtedy wyglądała następująco:

POST v2/apps/provider-project/entities/MenuItemOffer/menuitemoffer6680262:push
Host: actions.googleapis.com
Content-Type: application/ld+json
{
  "entity": {
    "data": {
      "@type": "MenuItemOffer",
      "@id": "menuitemoffer6680262",
      "sku": "offer-cola",
      "menuItemId": "menuitem896532",
      "price": 1.00,
      "priceCurrency": "USD"
    },
    "vertical": "FOODORDERING"
  }
}

Uwaga: w powyższym przykładzie „dane” nie są zserializowane jako ciąg znaków umożliwiający czytelność.

Dodawanie encji

Jeśli chcesz dodawać elementy, unikaj aktualizacji zasobów reklamowych. Zamiast tego skorzystaj z procesu przesyłania zbiorczych plików danych zgodnie ze schematem zasobów reklamowych w wersji 2.

Usuwanie elementu

Aby usunąć encje najwyższego poziomu, użyj nieco zmodyfikowanego punktu końcowego i w żądaniu użyj HTTP DELETE zamiast HTTP POST.

Nie używaj metody HTTP DELETE do usuwania elementu podrzędnego w jednostce najwyższego poziomu, np. pozycji menu w menu. Usunięcie podrzędnych elementów należy traktować jako aktualizację elementu najwyższego poziomu, w której element podrzędny jest usuwany z odpowiedniej listy lub parametru.

Przykład 1. Usuwanie elementu najwyższego poziomu

Przeanalizujmy sytuację, w której chcesz usunąć restaurację z pliku danych, który korzysta ze schematu asortymentu w wersji 1. Musisz też usunąć usługi i menu.

Przykładowy punkt końcowy elementu menu o identyfikatorze „https://www.provider.com/Restaurant/menu/nr”:

DELETE v2/apps/delivery-provider-id/entities/https%3A%2F%2Fwww.provider.com%2Frestaurant%2Fmenu%2Fnr?entity.vertical=FOODORDERING
Host: actions.googleapis.com

Przykładowy punkt końcowy elementu restauracji o identyfikatorze „https://www.provider.com/Restaurant/nr”:

DELETE v2/apps/delivery-provider-id/entities/https%3A%2F%2Fwww.provider.com%2Frestaurant%2Fnr?entity.vertical=FOODORDERING
Host: actions.googleapis.com

Przykładowy punkt końcowy dla encji usługi o identyfikatorze „https://www.provider.com/Restaurant/service/nr”:

DELETE v2/apps/delivery-provider-id/entities/https%3A%2F%2Fwww.provider.com%2Frestaurant%2Fservice%2Fnr?entity.vertical=FOODORDERING
Host: actions.googleapis.com
}

Przykład 2. Usuwanie podrzędnych elementów

Aby usunąć element podrzędny z elementu najwyższego poziomu, wyślij encję najwyższego poziomu z elementem podrzędnym usuniętym z odpowiedniego pola. W tym przykładzie założono, że plik danych korzysta ze schematu asortymentu w wersji 1.

Aby na przykład usunąć obsługiwany obszar, zaktualizuj usługę tak, aby został usunięty z listy areaServed.

POST v2/apps/delivery-provider-id/entities/https%3A%2F%2Fwww.provider.com%2Frestaurant%2Fservice%2Fnr:push
Host: actions.googleapis.com
Content-Type: application/ld+json
{
  "entity": {
    // Note: "data" is not serialized as a string in our example for readability.
    "data": {
      "@type": "Service",
      "provider": {
        "@type": "Restaurant",
        "@id": "https://www.provider.com/restaurant/nr"
      },
      "areaServed": [
        {
          "@type": "GeoCircle",
          "geoMidpoint": {
            "@type": "GeoCoordinates",
            "latitude": "42.362757",
            "longitude": "-71.087109"
          },
          "geoRadius": "10000"
        }
        // area2 is removed.
      ]
      ...
    },
    "vertical": "FOODORDERING"
  }
}

Uwaga: Google przetwarza usuwanie danych partiami, a nie w czasie rzeczywistym.

Kody odpowiedzi interfejsu API

Pomyślne wywołanie nie oznacza, że plik danych jest prawidłowy ani prawidłowy, tylko że zostało wykonane wywołanie interfejsu API. Pomyślne wywołania otrzymują kod odpowiedzi HTTP 200 i pustą treść odpowiedzi:

{}

W przypadku niepowodzenia kod odpowiedzi HTTP będzie inny niż 200, a jej treść będzie zawierać informacje o tym, co poszło nie tak.

Jeśli na przykład użytkownik ustawił w kopercie wartość „pionowa” na FAKE_VERTICAL, otrzymasz taki komunikat:

{
  "error": {
    "code": 400,
    "message": "Invalid value at 'entity.vertical' (TYPE_ENUM), \"FAKE_VERTICAL\"",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.BadRequest",
        "fieldViolations": [
          {
            "field": "entity.vertical",
            "description": "Invalid value at 'entity.vertical' (TYPE_ENUM), \"FAKE_VERTICAL\""
          }
        ]
      }
    ]
  }
}

Przykładowy kod

Poniżej znajdziesz kilka przykładów wykorzystania interfejsu Incremental Updates API w różnych językach. Te przykłady korzystają z Google Auth Libraries i zakładają, że plik danych korzysta ze schematu zasobów reklamowych w wersji 1. Alternatywne rozwiązania znajdziesz w artykule o używaniu OAuth 2.0 w aplikacjach międzyserwerowych.

Aktualizuję elementy

Node.js

Ten kod korzysta z biblioteki uwierzytelniania Google dla środowiska Node.js.

const {auth} = require('google-auth-library')
const request = require('request');
// The service account client secret file downloaded from the Google Cloud Console
const serviceAccountJson = require('./service-account.json')
// entity.json is a file that contains the entity data in json format
const entity = require('./entity.json')

const ENTITY_ID = 'restaurant/http://www.provider.com/somerestaurant'
const PROJECT_ID = 'your-project-id'

/**
 * Get the authorization token using a service account.
 */
async function getAuthToken() {
  let client = auth.fromJSON(serviceAccountJson)
  client.scopes = ['https://www.googleapis.com/auth/assistant']
  const tokens = await client.authorize()
  return tokens.access_token;
}

/**
 * Send an incremental update to update or add an entity
 */
async function updateEntity(entityId, entity) {
  const token = await getAuthToken()
  request.post({
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${token}`
    },
    url: `https://actions.googleapis.com/v2/apps/${PROJECT_ID}/entities/${encodeURIComponent(entityId)}:push`,
    body: {
      entity: {
        data: JSON.stringify(entity),
        vertical: 'FOODORDERING',
      }
    },
    json: true
  },
  (err, res, body) => {
    if (err) { return console.log(err); }
    console.log(`Response: ${JSON.stringify(res)}`)
  })
}

updateEntity(ENTITY_ID, entity)

Python

Ten kod korzysta z biblioteki uwierzytelniania Google na potrzeby Pythona.

from google.oauth2 import service_account
from google.auth.transport.requests import AuthorizedSession
import json
import urllib

PROJECT_ID = 'your-project-id'
ENTITY_ID = 'restaurant/http://www.provider.com/somerestaurant'
ENDPOINT = 'https://actions.googleapis.com/v2/apps/%s/entities/%s:push' % (
    PROJECT_ID, urllib.quote(ENTITY_ID, ''))

# service-account.json is the service account client secret file downloaded from the
# Google Cloud Console
credentials = service_account.Credentials.from_service_account_file(
    'service-account.json')

scoped_credentials = credentials.with_scopes(
    ['https://www.googleapis.com/auth/assistant'])

authed_session = AuthorizedSession(scoped_credentials)

# Retrieving the entity
update_file = open("entity.json")  #JSON file containing entity data in json format.
data = update_file.read()

# Populating the entity with wrapper
entity = {}
entity['data'] = data #entity JSON-LD serialized as string
entity['vertical'] = 'FOODORDERING'

request = {}
request['entity'] = entity

response = authed_session.post(ENDPOINT, json=request)

print(response.text) #if successful, will be '{}'

Java

Ten kod korzysta z biblioteki uwierzytelniania Google na potrzeby Javy.

private static final String PROJECT_ID = "your-project-id";
private static final String ENTITY_ID = "http://www.provider.com/somerestaurant";

/**
 * Get the authorization token using a service account.
 */
private static String getAuthToken() {
  InputStream serviceAccountFile =
      Example.class.getClassLoader().getResourceAsStream("service-account.json");
  ServiceAccountCredentials.Builder credentialsSimpleBuilder =
      ServiceAccountCredentials.fromStream(serviceAccountFile).toBuilder();
  credentialsSimpleBuilder.setScopes(ImmutableList.of("https://www.googleapis.com/auth/assistant"));
  AccessToken accessToken = credentialsSimpleBuilder.build().refreshAccessToken();
  return accessToken.getTokenValue();
}

/**
 * Send an incremental update to update or add an entity.
 * @param entityId The id of the entity to update.
 * @param entity the json of the entity to be updated.
 */
public void updateEntity(String entityId, JSONObject entity) {
  String authToken = getAuthToken();
  String endpoint = String.format(
      "https://actions.googleapis.com/v2/apps/%s/entities/%s:push",
      PROJECT_ID, URLEncoder.encode(entityId, "UTF-8"));
  JSONObject data = new JSONObject();
  data.put("data", entity.toString());
  data.put("vertical", "FOODORDERING");
  JSONObject jsonBody = new JSONObject();
  jsonBody.put("entity", data);
  // Execute POST request
  executePostRequest(endpoint, authToken, jsonBody);
}

Usuwanie elementów

Node.js

Ten kod korzysta z biblioteki uwierzytelniania Google dla środowiska Node.js.

const {auth} = require('google-auth-library')
const request = require('request');
// The service account client secret file downloaded from the Google Cloud Console
const serviceAccountJson = require('./service-account.json')
// entity.json is a file that contains the entity data in json format
const entity = require('./entity.json')

const ENTITY_ID = 'restaurant/http://www.provider.com/somerestaurant'
const PROJECT_ID = 'your-project-id'

/**
 * Get the authorization token using a service account.
 */
async function getAuthToken() {
  let client = auth.fromJSON(serviceAccountJson)
  client.scopes = ['https://www.googleapis.com/auth/assistant']
  const tokens = await client.authorize()
  return tokens.access_token;
}

/**
 * Send an incremental update to delete an entity
 */
async function deleteEntity(entityId) {
  const token = await getAuthToken()
  request.delete({
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${token}`
    },
    url: `https://actions.googleapis.com/v2/apps/${PROJECT_ID}/entities/${encodeURIComponent(entityId)}?entity.vertical=FOODORDERING`,
    body: {},
    json: true
  },
  (err, res, body) => {
    if (err) { return console.log(err); }
    console.log(`Response: ${JSON.stringify(res)}`)
  })
}

deleteEntity(ENTITY_ID)

Python

Ten kod korzysta z biblioteki uwierzytelniania Google na potrzeby Pythona.

from google.oauth2 import service_account
from google.auth.transport.requests import AuthorizedSession
import json
import urllib

# Service config
PROJECT_ID = 'your-project-id'
ENTITY_ID = 'restaurant/http://www.provider.com/somerestaurant'
DELETE_TIME = '2018-04-07T14:30:00-07:00'
ENDPOINT = 'https://actions.googleapis.com/v2/apps/%s/entities/%s?entity.vertical=FOODORDERING&delete_time=%s' % (
    PROJECT_ID, urllib.quote(ENTITY_ID, ''), urllib.quote(DELETE_TIME, ''))

# service-account.json is the service account client secret file downloaded from the
# Google Cloud Console
credentials = service_account.Credentials.from_service_account_file(
    'service-account.json')

scoped_credentials = credentials.with_scopes(
    ['https://www.googleapis.com/auth/assistant'])

authed_session = AuthorizedSession(scoped_credentials)
response = authed_session.delete(ENDPOINT)

print(response.text) #if successful, will be '{}'

Java

Ten kod korzysta z biblioteki uwierzytelniania Google na potrzeby Javy.

private static final String PROJECT_ID = "your-project-id";
private static final String ENTITY_ID = "restaurant/http://www.provider.com/somerestaurant";

/**
 * Get the authorization token using a service account.
 */
private static String getAuthToken() {
  InputStream serviceAccountFile = Example.class.getClassLoader().getResourceAsStream("service-account.json");
  ServiceAccountCredentials.Builder credentialsSimpleBuilder =
      ServiceAccountCredentials.fromStream(serviceAccountFile).toBuilder();
  credentialsSimpleBuilder.setScopes(ImmutableList.of("https://www.googleapis.com/auth/assistant"));
  AccessToken accessToken = credentialsSimpleBuilder.build().refreshAccessToken();
  return accessToken.getTokenValue();
}

/**
 * Send an incremental update to delete an entity.
 * @param entityId The id of the entity to delete.
 */
public void deleteEntity(String entityId) {
  String authToken = getAuthToken();
  String endpoint = String.format(
      "https://actions.googleapis.com/v2/apps/%s/entities/%s?entity.vertical=FOODORDERING",
      PROJECT_ID, URLEncoder.encode(entityId, "UTF-8"));
  // Execute DELETE request
  System.out.println(executeDeleteRequest(endpoint, authToken));
}

Przypadki użycia

W poniższych przypadkach użycia znajdują się przykłady aktualizacji przyrostowych, pełnych aktualizacji pliku danych i treści na wysokim poziomie w wywołaniu interfejsu API:

Scenariusz	Element najwyższego poziomu	Opis i efekty
Wyłączanie usługi	DisabledService	Usługę musisz wyłączyć z nieprzewidzianych powodów. Aktualizacje przyrostowe: wyślij odpowiednią encję Service z wartością @type zmienioną na DisabledService, ale pozostaw pozostałe właściwości bez zmian. Pełne pliki danych: pamiętaj, aby przed kolejnym pobraniem przez Google zaktualizować element z pełnych plików danych, tak aby parametr @type miał wartość DisabledService. W przeciwnym razie zostanie on ponownie włączony.
Konkretny produkt jest niedostępny	Menu	Aktualizacje przyrostowe: Wyślij encję jądrową Menu z wartością offer.inventoryLevel ustawioną na 0 dla danego MenuItem, a wszystkie pozostałe dane bez zmian.
Zmiana ceny elementu menu	Menu	Aktualizacje przyrostowe: Wyślij encję jądrową Menu z offer.price ustawioną na zaktualizowaną cenę danego MenuItem, a wszystkie pozostałe dane bez zmian.
Dodaj nowy element najwyższego poziomu Dotyczy tylko encji typów Menu, Restaurant i Service.	Menu, Restaurant, Service	Możesz na przykład dodać nowe menu do restauracji. Aktualizacje przyrostowe: wysłanie nowego elementu menu wraz z elementem restauracji wraz z polem hasMenu zostanie odpowiednio zaktualizowane.
Trwale usuń element najwyższego poziomu Dotyczy tylko encji typów Menu, Restaurant i Service.	Menu, Restaurant, Service	Aktualizacje przyrostowe: prześlij jednorazowe usunięcie. Pełne pliki danych: pamiętaj, aby usunąć element z pełnych plików danych przed kolejnym pobraniem przez Google. W przeciwnym razie zostanie on ponownie dodany.
Dodaj nowy obszar dostawy na wybranym koncie (Service)	Service	Dodatkowe pliki danych: wyślij problematyczny element Service z niezmienionymi wszystkimi polami, tak jak w przypadku pełnych plików danych, z nowym obszarem dostawy określonym w areaServed od Service.
Zaktualizuj szacowany czas dostawy w: Service	Service	Przyrostowe pliki danych: wysyłaj Service w taki sam sposób jak w plikach danych, z wyjątkiem tego, że jego parametr hoursAvailable.deliveryHours jest odpowiednio aktualizowany.
Zaktualizuj ceny dostawy w: Service	Service	Przyrostowe pliki danych: wysyłaj pełne pliki Service z aktualizacją offers.priceSpecification.price.
Zaktualizuj godziny dostawy lub na wynos w: Service	Service	Przyrostowe pliki danych: wysyłaj Service w taki sam sposób jak w plikach danych, z wyjątkiem tego, że jego parametr hoursAvailable jest odpowiednio aktualizowany.
Service (zmień minimalną kwotę zamówienia)	Service	Przyrostowe pliki danych: wysyłaj pełne pliki Service z aktualizacją Service.offers.priceSpecification.eligibleTransactionVolume
Trwale usuń usługę MenuItem	Menu	Przyrostowe pliki danych: wysyłaj Menu tak samo jak w plikach danych, ale usuń MenuItem z listy hasMenuItems.

Docelowy poziom usług w zakresie czasu przetwarzania zadań wsadowych i aktualizacji przyrostowych

Encja dodana w ramach aktualizacji zbiorczej lub przyrostowej zostanie przetworzona w ciągu 1–2 dni. Encja zaktualizowana lub usunięta przy użyciu wsadu zostanie przetworzona w ciągu 2 godzin, a encja zaktualizowana za pomocą przyrostowej aktualizacji – w ciągu 5 minut. Nieaktualny element jest usuwany za 7 dni.

Możesz wysłać do Google:

• wiele zadań wsadowych dziennie, aby zapewnić aktualność zasobów reklamowych; LUB
• Jedno zadanie wsadowe dziennie i przyrostowe interfejsy API, aby zapewnić aktualność asortymentu.