Ta strona została przetłumaczona przez Cloud Translation API.

Używanie interfejsu Chrome Web Store Publish API

Opis

Interfejs Chrome Web Store Publish API udostępnia zestaw punktów końcowych REST do programowego tworzenia, aktualizowania i publikowania elementów w Chrome Web Store.

Konfiguracja początkowa

Zanim zaczniesz wykonywać wywołania REST w sklepie Chrome Web Store, musisz włączyć interfejs Chrome Web Store API, skonfigurować ekran zgody OAuth i pobrać klucze dostępu interfejsu API. Ten proces znajdziesz w sekcjach poniżej.

Włączanie interfejsu Chrome Web Store API

Otwórz Google Cloud Console.
Utwórz nowy projekt lub wybierz już istniejący.
Na pasku wyszukiwania wpisz „Chrome Web Store API”.
Włącz Chrome Web Store API.

Konfigurowanie ekranu zgody OAuth

Otwórz ekran zgody OAuth.
Kliknij Zewnętrzny, a potem Utwórz.
Wypełnij wymagane pola Informacje o aplikacji (wymienione poniżej), a potem kliknij Zapisz i kontynuuj.
- Nazwa aplikacji.
- Adres e-mail zespołu pomocy.
- Kontaktowy adres e-mail dewelopera.
Pomiń zakresy. Kliknij Zapisz, a następnie Dalej.
Dodaj swój adres e-mail do sekcji Użytkownicy testowi, a następnie kliknij Zapisz i Dalej.

Uzyskiwanie kluczy dostępu

Otwórz Dane logowania.
Kliknij Utwórz dane logowania, a potem Identyfikator klienta OAuth.
Jako Typ aplikacji wybierz Aplikacja komputerowa.
Wpisz nazwę i kliknij Utwórz.

Konsola udostępni identyfikator klienta i tajny klucz klienta.

Testowanie aplikacji OAuth

Możesz pobrać token dostępu, aby móc pracować z interfejsem API. Na przykład wpisz ten URL w przeglądarce, zastępując $CLIENT_ID adresem powiązanym z Twoją aplikacją:

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

Wyświetli się strona z prośbą o zaakceptowanie uprawnień dla żądanego zakresu.

Prośba o zgodę
Interfejs

Kliknij Zaakceptuj i skopiuj kod. Powinna wyglądać mniej więcej tak:

Interfejs do kopiowania kodu

Za pomocą tej wartości zażądać tokena dostępu. Na przykład korzystając z curl, możesz uzyskać token dostępu, wykonując poniższe polecenie (zastępując wartości $CLIENT_ID, $CLIENT_SECRET i $CODE wartościami podanymi powyżej):

> 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"

Zwrócony zostanie taki wynik:

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

Możesz teraz używać access_token do wywoływania interfejsu API. Możesz też użyć tokena odświeżania, aby uzyskać przyszłe tokeny dostępu. Pamiętaj, że tokeny wygasają po godzinie.

Korzystanie z interfejsu API

Gdy masz token dostępu, rozszerzenie może korzystać z interfejsu Chrome Web Store Publish API. Istnieją punkty końcowe służące do tworzenia nowego elementu, aktualizowania istniejącego i publikowania elementu.

Poniżej znajdziesz listę uwag na temat korzystania z interfejsu Publish API:

Aby móc publikować lub aktualizować istniejące rozszerzenie, deweloperzy muszą włączyć na swoim koncie Google weryfikację dwuetapową.
Zanim opublikujesz nowy produkt, musisz wypełnić pola Informacje o aplikacji i Procedury ochrony prywatności w Panelu dewelopera.
Gdy opublikujesz nowy lub istniejący produkt, zostanie on sprawdzony. Więcej informacji znajdziesz w sekcji Proces sprawdzania.
Aby opublikować aktualizację, zwiększ liczbę w polu version pliku manifestu.

Więcej informacji o interfejsie Chrome Web Store Publish API znajdziesz tutaj.

Przesyłanie pakietu w celu utworzenia nowej pozycji w sklepie

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

Wpisz następujący przykład w wierszu poleceń:

> 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

Przesyłanie pakietu w celu zaktualizowania istniejącej pozycji w sklepie

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 to identyfikator istniejącego produktu w Chrome Web Store.

> 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

Publiczne publikowanie produktu

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

Publikowanie elementu dla zaufanych testerów

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

Sprawdzanie stanu przesyłania elementu

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