Przenoszenie zarządzania kontem

Interfejs Accounts API jest podzielony na kolekcję zasobów, aby umożliwić wydajniejsze zarządzanie kontami Merchant Center i dokładniejszą kontrolę nad różnymi aspektami konta.

W tym przewodniku opisujemy najważniejsze zmiany i pomagamy przenieść istniejącą integrację zarządzania kontem z Content API for Shopping do Merchant API.

Z jednego zasobu do wielu

W Content API for Shopping zasób Account był obiektem monolitycznym zawierającym wszystko, od nazwy konta i adresu URL witryny po listy użytkowników i informacje o firmie.

Merchant API dzieli je na kilka mniejszych, bardziej ukierunkowanych zasobów. Ta zmiana umożliwia bardziej ukierunkowane i efektywne wywołania interfejsu API. Jeśli na przykład chcesz zaktualizować tylko adres firmy, możesz teraz wysłać żądanie PATCH do zasobu BusinessInfo zamiast aktualizować cały obiekt Account.

Oto podsumowanie sposobu mapowania pojęć z zasobu Content API for Shopping Account na nowe zasoby w interfejsie Merchant API:

Nowe możliwości

Interfejs Merchant API wprowadza też nowe funkcje zarządzania kontem, które nie były dostępne w Content API for Shopping:

  • Warunki korzystania z usługi: możesz automatycznie pobierać i akceptować Warunki korzystania z usługi za pomocą zasobów TermsOfService i TermsOfServiceAgreementState.
  • Tworzenie konta: metoda accounts.createAndConfigure obsługuje teraz tworzenie kont z relacjami (takimi jak accountManagement), ustawianie alias i pomijanie potwierdzania adresu e-mail za pomocą pola user.verificationMailSettings.verificationMailMode na rzecz weryfikacji opartej na interfejsie API przy użyciu nowej metody accounts.verifySelf.
  • Dostęp do konta za pomocą aliasu: dostęp do kont za pomocą formatu providerId~accountAlias, który zapewnia firmom zarządzającym wieloma kontami spójny sposób korzystania z własnych identyfikatorów kont.

Żądania

Ta tabela zawiera skonsolidowane porównanie adresów URL żądań dotyczących typowych zadań związanych z zarządzaniem kontem w interfejsach Content API for Shopping i Merchant API.

Opis prośby Content API for Shopping Merchant API
Pobierz konto GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} GET https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Pobierz konto według aliasu Niedostępne bezpośrednio GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}~{alias}
Wyświetlanie listy subkont GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}:listSubaccounts
Utwórz subkonto POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts POST https://merchantapi.googleapis.com/accounts/v1/accounts:createAndConfigure
Aktualizowanie danych na koncie PUT https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} PATCH w odpowiednim zasobie. Aby na przykład zaktualizować nazwę konta: PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Usuwanie subkonta DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Zgłoś prawa do witryny POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/homepage:claim
Łączenie kont POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/link POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/services:propose

Zarządzanie podstawowymi informacjami o koncie

Zasób Account w Merchant API zawiera podstawowe informacje o koncie Merchant Center, takie jak nazwa, identyfikator i podstawowe ustawienia.

Porównanie żądań

Opis prośby Content API for Shopping Merchant API
Pobieranie szczegółów konta GET /content/v2.1/{merchantId}/accounts/{accountId} (dostęp do atrybutów podstawowych, takich jak name, adult_content) GET /accounts/v1/accounts/{account}
Tworzenie subkonta POST /content/v2.1/{merchantId}/accounts POST /accounts/v1/accounts:createAndConfigure
Zaktualizuj dane konta PUT /content/v2.1/{merchantId}/accounts/{accountId} (aktualizowanie atrybutów podstawowych) PATCH /accounts/v1/accounts/{account}
Usuwanie subkonta DELETE /content/v2.1/{merchantId}/accounts/{accountId} DELETE /accounts/v1/accounts/{account}

Szczegółowe porównanie pól

Content API for Shopping (Account) Merchant API (Account) Uwagi
id account_id Identyfikator numeryczny jest teraz polem tylko do odczytu. Identyfikator podstawowy to zasób name.
name account_name Zrozumiała dla człowieka nazwa konta.
language language_code Nazwa pola to teraz language_code.

Zarządzanie informacjami o firmie

Użyj zasobu BusinessInfo, aby zarządzać publicznymi informacjami o swojej firmie, takimi jak adres i dane kontaktowe obsługi klienta. Zastępuje on obiekt businessInformation w Content API for Shopping.

Porównanie żądań

Opis prośby Content API for Shopping Merchant API
Uzyskiwanie informacji o firmie GET /content/v2.1/{merchantId}/accounts/{accountId} (uzyskiwanie dostępu do atrybutu business_information) GET /accounts/v1/accounts/{account}/businessInfo
Zaktualizuj informacje o firmie PUT /content/v2.1/{merchantId}/accounts/{accountId} (aktualizacja atrybutu business_information) PATCH /accounts/v1/accounts/{account}/businessInfo

Szczegółowe porównanie pól

Content API for Shopping (business_information) Merchant API (BusinessInfo) Uwagi
phone_number phone Pole jest teraz phone i używa google.type.PhoneNumber.
customer_service.url customer_service.uri Nazwa pola to teraz uri.

Zarządzanie stroną główną

Aby zarządzać adresem URL witryny sklepu oraz przeprowadzić weryfikację i zgłosić prawa, użyj zasobu Homepage. Zastępuje on pole websiteUrl i metodę accounts.claimwebsite z Content API for Shopping.

Porównanie żądań

Opis prośby Content API for Shopping Merchant API
Pobieranie adresu URL strony głównej GET /content/v2.1/{merchantId}/accounts/{accountId} (uzyskiwanie dostępu do atrybutu website_url) GET /accounts/v1/accounts/{account}/homepage
Aktualizacja adresu URL strony głównej PUT /content/v2.1/{merchantId}/accounts/{accountId} (aktualizacja atrybutu website_url) PATCH /accounts/v1/accounts/{account}/homepage
Strona główna roszczeń POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST /accounts/v1/accounts/{account}/homepage:claim
Usuń rezerwację strony głównej Niedostępne POST /accounts/v1/accounts/{account}/homepage:unclaim

Szczegółowe porównanie pól

Content API for Shopping (Account) Merchant API (Homepage) Uwagi
website_url uri Adres URL strony głównej sklepu.
Niedostępne bezpośrednio claimed Pole wartości logicznej, które ma wartość true, jeśli strona główna jest zgłoszona.

Zarządzanie użytkownikami

Zasób User umożliwia zarządzanie dostępem do konta Merchant Center. Zastępuje tablicę users w zasobie Account. Główną różnicą jest proces tworzenia użytkowników. W interfejsie Merchant API dodanie użytkownika powoduje wysłanie zaproszenia. Użytkownik musi zaakceptować zaproszenie, zanim będzie mógł uzyskać dostęp do konta.

Porównanie żądań

Opis prośby Content API for Shopping Merchant API
Wyświetlenie użytkowników GET /content/v2.1/{merchantId}/accounts/{accountId} (uzyskiwanie dostępu do atrybutu users) GET /accounts/v1/accounts/{account}/users
Tworzenie konta użytkownika PUT /content/v2.1/{merchantId}/accounts/{accountId} (aktualizacja atrybutu users) POST /accounts/v1/accounts/{account}/users
Aktualizowanie użytkownika PUT /content/v2.1/{merchantId}/accounts/{accountId} (aktualizacja atrybutu users) PATCH /accounts/v1/accounts/{account}/users/{email}
Usuwanie użytkownika PUT /content/v2.1/{merchantId}/accounts/{accountId} (aktualizacja atrybutu users) DELETE /accounts/v1/accounts/{account}/users/{email}

Szczegółowe porównanie pól

Content API for Shopping (obiekt tablicy users) Merchant API (zasób User) Uwagi
email_address name (w formacie accounts/{account}/users/{email}) Adres e-mail użytkownika jest teraz częścią nazwy zasobu.
admin, order_manager, reporting_manager itp. access_rights Prawa dostępu są teraz skonsolidowane w powtarzającym się polu typu wyliczeniowego.
Niedostępne state Nowe pole tylko do odczytu, które wskazuje, czy użytkownik jest PENDING czy VERIFIED.

Zarządzanie relacjami i usługami na koncie

W Content API for Shopping relacjami zarządzano za pomocą accounts.link. Merchant API wprowadza bardziej przejrzysty model z zasobami AccountService i AccountRelationship, który wymaga procesu uzgadniania (proponowanie i akceptowanie).

Porównanie żądań

Opis prośby Content API for Shopping Merchant API
Łączenie kont POST /content/v2.1/{merchantId}/accounts/{accountId}/link POST /accounts/v1/accounts/{account}/services:propose
Wyświetlanie listy połączonych kont GET /content/v2.1/{merchantId}/accounts/{accountId}/listlinks GET /accounts/v1/accounts/{account}/relationships i GET /accounts/v1/accounts/{account}/services

Szczegółowe porównanie pól

Content API for Shopping (AccountLink) Merchant API (AccountService, AccountRelationship) Uwagi
linked_account_id provider (w: AccountService) Identyfikator konta, które świadczy usługę.
service service_type (w: AccountService) rodzaj świadczonej usługi (np. ACCOUNT_AGGREGATION);
status handshake.approval_state (w: AccountService) Stan linku (np. PENDING, ESTABLISHED).

Ustawienia podatków na koncie

Usługa accounttax z Content API for Shopping nie jest dostępna w Merchant API. Nie trzeba już podawać podatku od sprzedaży w Stanach Zjednoczonych. Więcej informacji znajdziesz w artykule Aktualizacja specyfikacji danych produktów w Merchant Center (2025 r.).

Zarządzanie tożsamością firmy

Użyj zasobu BusinessIdentity, aby samodzielnie zadeklarować atrybuty dotyczące Twojej firmy. Zastępuje on obiekt businessIdentity w Content API for Shopping.

Porównanie żądań

Opis prośby Content API for Shopping Merchant API
Uzyskiwanie tożsamości firmy GET /content/v2.1/{merchantId}/accounts/{accountId} (uzyskiwanie dostępu do atrybutu business_identity) GET /accounts/v1/accounts/{account}/businessIdentity
Aktualizowanie tożsamości firmy PUT /content/v2.1/{merchantId}/accounts/{accountId} (aktualizacja atrybutu business_identity) PATCH /accounts/v1/accounts/{account}/businessIdentity

Szczegółowe porównanie pól

Content API for Shopping (business_identity) Merchant API (BusinessIdentity) Uwagi
black_owned.self_identified (wartość logiczna) black_owned.identity_declaration (wyliczenie) Wartość logiczna została zastąpiona typem wyliczeniowym (SELF_IDENTIFIES_AS, DOES_NOT_SELF_IDENTIFY_AS), aby deklaracja była bardziej jednoznaczna. Dotyczy to wszystkich atrybutów tożsamości.
include_for_promotions (wartość logiczna) promotions_consent (wyliczenie) Globalna wartość logiczna została zastąpiona bardziej opisowym typem wyliczeniowym (PROMOTIONS_CONSENT_GIVEN, PROMOTIONS_CONSENT_DENIED).

Wyświetlanie listy kont

W Content API for Shopping jedynym typem konta zaawansowanego było „multikonto klientów (MCA)”, które udostępniało metodę accounts.list do wyświetlania listy kont danego multikonta klientów. Konta zaawansowane w Merchant API są znacznie bardziej zaawansowane i umożliwiają korzystanie z szerszego zakresu typów kont i relacji. Aby umożliwić prostą migrację kont zaawansowanych, Merchant API udostępnia bezpośredni odpowiednik metody accounts.list interfejsu Content API for Shopping jako metodę accounts.listSubaccounts. Wprowadzamy nową, bardziej zaawansowaną metodę accounts.list, która umożliwia zaawansowane filtrowanie kont.

Porównanie żądań

Opis prośby Content API for Shopping Merchant API
Wyświetlanie listy kont na koncie zaawansowanym GET /content/v2.1/{merchantId}/accounts GET /accounts/v1/accounts/{providerId}:listSubaccounts
Wyświetlanie listy wszystkich dostępnych kont Niedostępne GET /accounts/v1/accounts

Szczegółowe porównanie pól (parametry żądania)

Content API for Shopping (accounts.list) Merchant API (accounts.listSubaccounts) Uwagi
merchant_id (parametr ścieżki) provider (parametr ścieżki) Identyfikator konta zaawansowanego w formacie accounts/{account}.
max_results page_size Maksymalna liczba kont do zwrócenia.
Wstecz
Refactor code for concurrent requests
Dalej
Migrate accountstatuses to Account Issues