Используйте API публикации в Интернет-магазине Chrome.

Обзор

API публикации Интернет-магазина Chrome предоставляет набор конечных точек REST для программного создания, обновления и публикации элементов в Интернет-магазине Chrome.

Начальная настройка

Прежде чем вы сможете начать выполнять вызовы REST к Интернет-магазину Chrome, вам необходимо включить API Интернет-магазина Chrome, настроить экран согласия OAuth и получить ключи доступа к API. В следующих разделах описан этот процесс.

Включите API Интернет-магазина Chrome

1. Перейдите в облачную консоль Google .
2. Создайте новый проект или выберите существующий.
3. В строке поиска введите «API Интернет-магазина Chrome».
4. Включите API Интернет-магазина Chrome .

Настройка экрана согласия OAuth

1. Перейдите на экран согласия OAuth .
2. Выберите «Внешний» , затем «Создать» .
3. Заполните необходимые поля с информацией о приложении (перечислены ниже), затем нажмите «Сохранить и продолжить» .
   • Имя приложения.
   • Электронная почта службы поддержки пользователей.
   • Контактный адрес электронной почты разработчика.
4. Пропустить области. нажмите «Сохранить» , затем «Продолжить» .
5. Добавьте свой адрес электронной почты в список тестовых пользователей , затем нажмите «Сохранить» , а затем «Продолжить» .

Получите ключи доступа

1. Перейдите в раздел «Учетные данные» .
2. Нажмите «Создать учетные данные» , затем «Идентификатор клиента OAuth» .
3. В качестве типа приложения выберите Desktop App .
4. Введите имя и нажмите «Создать» .

Консоль предоставит идентификатор клиента и секрет клиента.

Тестирование вашего приложения OAuth

Вы можете получить токен доступа для работы с API. Например, введите этот URL-адрес в своем браузере, заменив $CLIENT_ID на URL-адрес вашего приложения:

https://accounts.google.com/o/oauth2/auth?response_type=code&scope=https://www.googleapis.com/auth/chromewebstore&client_id=$CLIENT_ID&redirect_uri=urn:ietf:wg:oauth:2.0:oob

Вы увидите страницу с просьбой принять разрешение для запрошенной области.

Примечание. Убедитесь, что вы запрашиваете токен, используя учетную запись разработчика Google, которой принадлежат элементы Интернет-магазина Chrome, которыми вы хотите управлять. Эта учетная запись может отличаться от учетной записи, с помощью которой вы создали проект Google Developers Console. Например, вы можете создать приложение, чтобы другие разработчики могли управлять своими приложениями, и в этом случае вам нужно всего лишь зарегистрировать проект консоли разработчиков Google.

Нажмите «Принять» и скопируйте код. Это должно выглядеть примерно так:

Используйте это значение для запроса токена доступа . Например, используя curl , вы можете получить токен доступа, выполнив следующую команду (заменив значения $CLIENT_ID, $CLIENT_SECRET и $CODE значениями, указанными выше):

> curl "https://accounts.google.com/o/oauth2/token" -d \
"client_id=$CLIENT_ID&client_secret=$CLIENT_SECRET&code=$CODE&grant_type=authorization_code&redirect_uri=urn:ietf:wg:oauth:2.0:oob"

Это вернет такой результат, как:

{
  "access_token" : "ya29...",
  "expires_in" : 3600,
  "refresh_token" : "1/rwn...",
  "scope": "https://www.googleapis.com/auth/chromewebstore",
  "token_type" : "Bearer",
}

Теперь вы можете использовать access_token для вызова API. Вы также можете использовать токен обновления для получения будущих токенов доступа. Обратите внимание, что срок действия токенов истекает через час.

Примечание. Дополнительную информацию о получении токенов доступа OAuth 2.0 см. в разделе [Использование OAuth 2.0 для доступа к API Google][oauth2].

Использование API

Получив токен доступа, ваше расширение сможет использовать API публикации Интернет-магазина Chrome. Существуют конечные точки для создания нового элемента, обновления существующего элемента и публикации элемента.

Ниже приведен список рекомендаций по использованию API публикации:

• Разработчики должны включить двухэтапную аутентификацию для своей учетной записи Google, чтобы опубликовать или обновить существующее расширение.
• Прежде чем вы сможете опубликовать новый элемент, вам необходимо заполнить вкладки «Список магазинов» и «Порядок конфиденциальности» на панели инструментов разработчика .
• После публикации нового или существующего элемента он проходит процедуру проверки. Дополнительную информацию см. в разделе «Процесс проверки» .
• Чтобы выпустить обновление, увеличьте число в поле версии манифеста.

Подробнее об API публикации в Интернет-магазине Chrome можно узнать здесь .

Загрузка пакета для создания нового товара в магазине

Endpoint: https://www.googleapis.com/upload/chromewebstore/v1.1/items
Type: POST
Header Parameters: 
  $TOKEN: the access token
Body content: the package file to upload

Введите следующий пример в командной строке:

> curl \
-H "Authorization: Bearer $TOKEN"  \
-H "x-goog-api-version: 2" \
-X POST \
-T $FILE_NAME \
-v \
https://www.googleapis.com/upload/chromewebstore/v1.1/items

Примечание. Полное описание метода вставки см. в разделе [Items:Insert][cws-api-insert].

Загрузка пакета для обновления существующего товара в магазине

Endpoint: https://www.googleapis.com/upload/chromewebstore/v1.1/items/$ITEM_ID
Type: PUT
Header Parameters: 
  $TOKEN: the access token
Body content: the package file to upload

$ITEM_ID — это идентификатор существующего элемента Интернет-магазина.

> curl \
-H "Authorization: Bearer $TOKEN"  \
-H "x-goog-api-version: 2" \
-X PUT \
-T $FILE_NAME \
-v \
https://www.googleapis.com/upload/chromewebstore/v1.1/items/$ITEM_ID

Примечание. Полное описание метода обновления см. в разделе [Items:Update][cws-api-update].

Публикация элемента для общего доступа

Endpoint: https://www.googleapis.com/chromewebstore/v1.1/items/$ITEM_ID/publish
Type: POST
Header Parameters: 
  $TOKEN: the access token

> curl \
-H "Authorization: Bearer $TOKEN"  \
-H "x-goog-api-version: 2" \
-H "Content-Length: 0" \
-X POST \
-v \
https://www.googleapis.com/chromewebstore/v1.1/items/$ITEM_ID/publish

Примечание. Полное описание метода публикации см. в разделе [Items:Publish][cws-api-publish].

Публикация элемента для доверенных тестировщиков

Endpoint: https://www.googleapis.com/chromewebstore/v1.1/items/$ITEM_ID/publish?publishTarget=trustedTesters
Type: POST
Header Parameters: 
  $TOKEN: the access token

> curl \
-H "Authorization: Bearer $TOKEN"  \
-H "x-goog-api-version: 2" \
-H "Content-Length: 0" \
-X POST \
-v \
https://www.googleapis.com/chromewebstore/v1.1/items/$ITEM_ID/publish?publishTarget=trustedTesters

Примечание. Полное описание метода публикации см. в разделе [Items:Publish][cws-api-publish].

Проверка статуса загрузки элемента

Endpoint: https://www.googleapis.com/chromewebstore/v1.1/items/$ITEM_ID?projection=DRAFT
Type: GET
Header Parameters: 
  $TOKEN: the access token

curl \
-H "Authorization: Bearer $TOKEN"  \
-H "x-goog-api-version: 2" \
-H "Content-Length: 0" \
-H "Expect:" \
-X GET \
-v \
https://www.googleapis.com/chromewebstore/v1.1/items/$ITEM_ID?projection=DRAFT

Примечание. В настоящее время поддерживается только Projection=DRAFT . Полное описание метода get см. в разделе [Items:Get][cws-api-get].