Używanie dodatkowych plików danych w Content API

Za pomocą dodatkowych plików danych możesz częściowo zaktualizować dane produktów poprzez dodanie feedId jako parametru zapytania przy wywołaniach funkcji products.insert, products.delete, products.custombatch.insert oraz products.custombatch.delete .

Możesz na przykład wywołać metodę products.insert dodatkowego pliku danych do ten adres URL:

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId

products.insert

Metoda products.insert w dodatkowym pliku danych dodaje pola produktów, które przesyłasz w treści żądania, zastępując te pola, jeśli istnieją. Jeśli używasz tagu dodatkowego pliku danych, ta metoda pozostawia wszystkie pozostałe pola produktu bez zmian, były uwzględnione w poprzedniej prośbie dotyczącej tego samego pliku danych. Dane dodane za pomocą innych plików danych, każde żądanie nadpisze poprzednie. dotyczące tego samego kanału. Oznacza to, że jeśli dodasz lub zaktualizujesz pole za pomocą i nie dodawaj tego pola do kolejnego żądania dodatkowego pliku danych dane dla pominiętego pola zostaną usunięte z pliku danych. To zachowanie różni się od wywoływania funkcji products.insert bez dodatkowego pliku danych, usuwa wszystkie istniejące dane produktów i zastępuje je polami przesłanymi w treść żądania.

Użyj tego adresu URL, aby przesłać prośbę o dodatkowy plik danych Usługa Product.insert:

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId

Musisz uwzględnić offerId, feedLabel, channel i contentLanguage w treści żądania. Wszystkie pozostałe pola są opcjonalne.

Przykład

Aby zmienić dostępność produktu z „w magazynie” na „niedostępny”, musisz: można użyć poniższego treści żądania, aby utworzyć dodatkowe pliki danych Wywołanie metody Product.insert:

{
 "offerId": "1111111111",
 "contentLanguage": "en",
 "feedLabel": "US",
 "channel": "online",
 "availability": "out of stock",
}

products.delete

Metoda products.delete usuwa wszystkie dodatkowe dane, które zostały wcześniej dodane przez products.insert wywołania za pomocą określonego uzupełniającego kanału. Wywołanie tej metody w celu utworzenia dodatkowego pliku danych nie ma wpływu na oryginał. dane produktów dodane przed wywołaniami Product.insert dodatkowego pliku danych podjętych działań. Można to wyobrazić sobie jako usuwanie warstwy danych z konkretnego pliku danych. nie wpłynie na dane dodane za pomocą innych plików danych, a produkt przywraca stan sprzed dodania warstwy dodatkowego pliku danych. Ten różni się od wywoływania funkcji products.delete bez dodatkowego pliku danych, powoduje usunięcie całego produktu i wszystkich jego danych.

Użyj poniższego adresu URL, aby przesłać prośbę o dodatkowy plik danych products.delete usługi, gdzie productId to Identyfikator REST produktu reprezentowanego jako: channel:contentLanguage:feedLabel:offerId:

DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId?feedId=feedId

Wywołania metody products.delete w dodatkowych plikach danych nie wymagają treści żądania.

products.custombatch

Metody custombatch umożliwiają przesłanie insert lub delete dodatkowego pliku danych dla wielu produktów za pomocą jednego wywołania API w celu zminimalizowania liczby interfejsów API wykonanych połączeń.

Aby wywołać funkcję custombatch, użyj tego adresu URL żądania:

https://shoppingcontent.googleapis.com/content/v2.1/products/batch

W przypadku wszystkich wywołań funkcji custombatch w dodatkowym pliku danych należy stosować parametry batchId, Parametry merchantID, method i feedId w żądaniu .

products.custombatch:insert

Jeśli odwołujesz się do metody products.custombatch:insert za pomocą dodatkowego pliku danych, musisz uwzględnić offerId, feedLabel, channel oraz contentLanguage w treści żądania, oprócz wymaganych batchId, Parametry merchantID i method. Wszystkie pozostałe pola produktu są opcjonalne.

Przykład

Aby zaktualizować wartość price w przypadku 2 istniejących produktów, możesz użyć polecenia następujące żądanie, aby wywołać metodę products.custombatch:insert:.

{
  "entries": [
    {
      "batchId": 1111,
      "merchantId": 1234567,
      "method": "insert",
      "feedId": "7654321",
      "product": {
         "offerId": "1111111111",
         "contentLanguage": "en",
         "targetCountry": "US",
         "feedLabel": "US",
         "channel": "online",
         "price": {
          "value": "30.99",
          "currency": "USD"
         }
      }
    },
    {
      "batchId": 1112,
      "merchantId": 1234567,
      "method": "insert",
      "feedId": "7654321",
      "product": {
         "offerId": "2222222222",
         "contentLanguage": "en",
         "targetCountry": "US",
         "feedLabel": "US",
         "channel": "online",
         "price": {
          "value": "33.99",
          "currency": "USD"
         },
      },
    }
}

products.custombatch:delete

Aby usunąć wszystkie aktualizacje 2 produktów wprowadzone za pomocą określonego dodatkowego pliku danych: można użyć poniższego żądania, aby utworzyć products.custombatch:delete wywołanie metody:

{
  "entries": [
    {
      "batchId": 1115,
      "merchantId": 1234567,
      "method": "delete",
      "feedId": "7654321",
      "productId": "online:en:US:1111111111"
    },
    {
      "batchId": 1116,
      "merchantId": 1234567,
      "method": "delete",
      "feedId": "7654321",
      "productId": "online:en:US:2222222222"
    }
  ]
}