Überblick
Die Chrome Web Store Publish API bietet eine Reihe von REST-Endpunkten zum programmatischen Erstellen, Aktualisieren und Veröffentlichen von Elementen im Chrome Web Store.
Ersteinrichtung
Bevor Sie REST-Aufrufe an den Chrome Web Store ausführen können, müssen Sie die Chrome Web Store API aktivieren, Ihren OAuth-Zustimmungsbildschirm konfigurieren und Ihre API-Zugriffsschlüssel abrufen. Dieser Vorgang wird in den folgenden Abschnitten beschrieben.
Chrome Web Store API aktivieren
- Rufen Sie die Google Cloud Console auf.
- Erstellen Sie ein neues Projekt oder wählen Sie ein vorhandenes aus.
- Geben Sie in die Suchleiste „Chrome Web Store API“ ein.
- Aktivieren Sie die Chrome Web Store API.
OAuth-Zustimmungsbildschirm konfigurieren
- Rufen Sie den OAuth-Zustimmungsbildschirm auf.
- Wählen Sie Extern und dann Erstellen aus.
- F�llen Sie die unten aufgef�hrten Pflichtfelder aus und klicken Sie auf Speichern und fortfahren.
- App-Name
- E-Mail-Adresse des Nutzersupports.
- E-Mail-Adresse des Entwicklers.
- �berspringen Sie Bereiche. Klicken Sie auf Speichern und dann auf Weiter.
- F�gen Sie Ihre E-Mail-Adresse zu Testnutzer hinzu, klicken Sie auf Speichern und dann auf Weiter.
Zugriffsschl�ssel abrufen
- Gehen Sie zu Anmeldedaten.
- Klicken Sie auf Anmeldedaten erstellen und dann auf OAuth-Client-ID.
- W�hlen Sie als Anwendungstyp die Option Desktop-App aus.
- Geben Sie einen Namen ein und klicken Sie auf Erstellen.
In der Konsole werden die Client-ID und der Clientschl�ssel bereitgestellt.
OAuth-Anwendung testen
Sie k�nnen ein Zugriffstoken f�r die Arbeit mit der API abrufen. Geben Sie beispielsweise die folgende URL in Ihren Browser ein und ersetzen Sie dabei $CLIENT_ID durch die ID f�r Ihre Anwendung:
https://accounts.google.com/o/oauth2/auth?response_type=code&scope=/proxy/https://www.googleapis.com/auth/chromewebstore&client_id=$CLIENT_ID&redirect_uri=urn:ietf:wg:oauth:2.0:oob
Sie werden auf einer Seite aufgefordert, die Berechtigung f�r den angeforderten Bereich zu akzeptieren.
Klicken Sie auf Akzeptieren und kopieren Sie den Code. Die Ausgabe sollte ungef�hr so aussehen:
Verwenden Sie diesen Wert, um ein Zugriffstoken anzufordern. Wenn Sie beispielsweise curl
verwenden, k�nnen Sie ein Zugriffstoken abrufen, indem Sie den folgenden Befehl ausf�hren. Dabei ersetzen Sie die Werte von $CLIENT_ID, $CLIENT_SECRET und $CODE durch die oben angegebenen Werte:
> 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"
Dadurch wird ein Ergebnis wie dieses zur�ckgegeben:
{
"access_token" : "ya29...",
"expires_in" : 3600,
"refresh_token" : "1/rwn...",
"scope": "https://www.googleapis.com/auth/chromewebstore",
"token_type" : "Bearer",
}
Sie k�nnen jetzt die access_token
verwenden, um die API aufzurufen. Sie k�nnen das Aktualisierungstoken auch verwenden, um zuk�nftige Zugriffstokens abzurufen. Tokens laufen nach einer Stunde ab.
API verwenden
Sobald Sie ein Zugriffstoken haben, kann Ihre Erweiterung die Chrome Web Store Publish API verwenden. Es gibt Endpunkte, mit denen neue Elemente erstellt, vorhandene Elemente aktualisiert und ver�ffentlicht werden k�nnen.
Im Folgenden finden Sie eine Liste mit �berlegungen zur Verwendung der Publish API:
- Entwickler m�ssen f�r ihr Google-Konto die Best�tigung in zwei Schritten aktivieren, um eine Erweiterung zu ver�ffentlichen oder zu aktualisieren.
- Bevor du einen neuen Artikel ver�ffentlichen kannst, musst du die Tabs Store-Eintrag und Umgang mit dem Datenschutz im Entwickler-Dashboard ausf�llen.
- Nach der Ver�ffentlichung eines neuen oder vorhandenen Artikels wird dieser einer �berpr�fung unterzogen. Weitere Informationen finden Sie unter �berpr�fungsprozess.
- Wenn Sie ein Update ver�ffentlichen m�chten, erh�hen Sie die Zahl im Feld version des Manifests.
Weitere Informationen zur Chrome Web Store Publish API
Paket hochladen, um einen neuen Store-Artikel zu erstellen
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
Geben Sie das folgende Beispiel in die Befehlszeile ein:
> 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
Paket hochladen, um einen vorhandenen Artikel im Store zu aktualisieren
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“ ist die ID des vorhandenen Web Store-Artikels.
> 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
Veröffentlichen eines Artikels
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
Artikel für Trusted Tester veröffentlichen
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
Uploadstatus eines Elements prüfen
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