Вы можете использовать ресурс accounts
для создания и управления своей учетной записью продавца. Дополнительную информацию см. в разделе Обзор API учетных записей продавцов .
На этой странице описано, как перенести управление учетными записями из Content API в Merchant API.
Запросы
Используйте следующий формат URL-адреса запроса для API учетных записей торговцев:
POST https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/accounts
Ниже приведен пример сравнения Content API для покупок с API учетных записей продавцов для запросов на создание и управление учетными записями:
API контента для покупок | API торговых счетов | |
---|---|---|
URL-адрес | https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId} /accounts/ {accountId} / | https://merchantapi.googleapis.com/accounts/v1beta/ {accountId} /accounts |
Идентификаторы | {merchantId} /accounts/ {accountId} | {accountId} |
Ресурсы
Данные учетной записи передаются с использованием ресурса Account
в Content API for Shopping. API учетных записей торговцев предоставляет несколько ресурсов для передачи данных учетных записей. Эти ресурсы включают ресурсы Account
, User
, BusinessInfo
и BusinessIdentity
.
В следующей таблице представлено сравнение ресурса Account
в Content API для покупок и ресурса Account
в API учетных записей продавцов.
API контента для покупок | API торговых счетов |
---|---|
id | account_id |
name | account_name |
kind | Нет в наличии |
websiteUrl | Поле uri на ресурсе homepage |
adultContent | adult_content |
sellerId | Нет в наличии |
users | В ресурсе User |
youtubeChannelLinks | Пока недоступно |
googleMyBusinessLink | Пока недоступно |
businessInformation | На ресурсе businessInfo |
businessIdentity | В businessIdentity Identity |
automaticImprovements | Пока недоступно |
adsLinks | Пока недоступно |
cssId | Доступно только в CSS API. |
labelIds | Доступно только в CSS API. |
accountManagement | Пока недоступно |
automaticLabelIds | Доступно только в CSS API. |
conversionSettings | Пока недоступно |
В следующей таблице представлено сравнение ресурса AccountUser
в Content API для покупок и ресурса User
в API учетных записей продавцов.
API контента для покупок | API торговых счетов |
---|---|
emailAddress | email является частью name (accounts/{account}/users/{email}) . |
admin | user#access_rights.ADMIN |
orderManager | Нет в наличии |
paymentsManager | Нет в наличии |
paymentsAnalyst | Нет в наличии |
reportingManager | user#access_rights.PERFORMANCE_REPORTING |
В следующей таблице представлено сравнение ресурса AccountBusinessInformation
в Content API for Shopping и его эквивалентного ресурса businessinfo
в API Merchant Accounts API.
API контента для покупок | API торговых счетов |
---|---|
businessInformation | businessinfo |
phoneNumber | phone |
phoneVerificationStatus | phone_verification_state |
customerService | customer_service |
koreanBusinessRegistrationNumber | Нет в наличии |
В следующей таблице представлено сравнение ресурса AccountBusinessIdentity
в Content API для покупок и ресурса businessIdentity
в API учетных записей продавцов.
API контента для покупок | API торговых счетов |
---|---|
blackOwned | black_owned |
womenOwned | women_owned |
veteranOwned | veteran_owned |
latinoOwned | latino_owned |
smallBusiness | small_business |
includeForPromotions | promotions_consent true означает PROMOTION_CONSENT_GIVEN false означает PROMOTION_CONSENT_DENIED |
В следующей таблице представлено сравнение ресурса AccountIdentityType
в Content API для покупок и identityAttribute
в API учетных записей продавцов.
API контента для покупок | API торговых счетов |
---|---|
self_identified | identity_declaration true означает SELF_IDENTIFIES_AS false означает DOES_NOT_SELF_IDENTIFY_AS |
Методы
В API торговых счетов были введены следующие методы:
API контента для покупок | API торговых счетов |
---|---|
accounts.authinfo | GET https://merchantapi.googleapis.com/accounts/v1beta/accounts без фильтра |
accounts.claimwebsite | POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/ accountId /homepage:claim Дополнительную информацию см. в разделе Метод: account.v1beta.accounts.homepage.claim. |
accounts.custombatch | Нет в наличии. Специальная партия не поддерживается в Merchant API. |
аккаунты.удалить | DELETE https://merchantapi.googleapis.com/accounts/v1beta/accounts/ accountId |
accounts.get | Сопоставляется с запросом GET для ресурса, в котором определено необходимое поле или набор полей. |
accounts.insert | POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure Дополнительную информацию см. в разделе Создание и настройка учетной записи продавца . |
accounts.link | Пока не поддерживается |
accounts.list | GET https://merchantapi.googleapis.com/accounts/v1beta/ accountId :listSubaccounts |
accounts.listlinks | Пока не поддерживается |
accounts.update | Сопоставляется с запросом на обновление ресурса, в котором определено необходимое поле или набор полей. |