REST Resource: users

Ressource: User

Eine Nutzerressource.

JSON-Darstellung
{
  "name": string,
  "email": string,
  "accessState": enum (AccessState),
  "expirationTime": string,
  "partial": boolean,
  "developerAccountPermissions": [
    enum (DeveloperLevelPermission)
  ],
  "grants": [
    {
      object (Grant)
    }
  ]
}
Felder
name

string

Erforderlich. Ressourcenname für diesen Nutzer nach dem Muster „developers/{developer}/users/{email}“.

email

string

Nicht veränderbar. Die E-Mail-Adresse des Nutzers.

accessState

enum (AccessState)

Nur Ausgabe. Der Status des Zugriffs des Nutzers auf die Play Console.

expirationTime

string (Timestamp format)

Die Zeit, zu der der Zugriff des Nutzers abläuft, sofern festgelegt. Dieser Wert muss immer in der Zukunft liegen.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

partial

boolean

Nur Ausgabe. Gibt an, ob der Nutzer weitere Berechtigungen hat, die hier nicht aufgeführt sind. Das kann passieren, wenn der Aufrufer nicht berechtigt ist, alle Apps im Konto zu verwalten. Das ist auch true, wenn dieser Nutzer der Kontoinhaber ist.

Wenn dieses Feld true ist, sollte dies als Signal dafür gewertet werden, dass dieser Nutzer nicht vollständig über die API verwaltet werden kann. Das heißt, der API-Aufrufer kann nicht alle Berechtigungen dieses Nutzers verwalten, entweder weil er sie nicht kennt oder weil der Nutzer der Kontoinhaber ist.

developerAccountPermissions[]

enum (DeveloperLevelPermission)

Berechtigungen für den Nutzer, die für das gesamte Entwicklerkonto gelten.

grants[]

object (Grant)

Nur Ausgabe. Berechtigungen pro App für den Nutzer.

AccessState

Der Status des Zugriffs eines Nutzers auf ein Entwicklerkonto.

Enums
ACCESS_STATE_UNSPECIFIED Unbekannter oder nicht angegebener Zugriffsstatus.
INVITED Der Nutzer wurde eingeladen, hat die Einladung aber noch nicht angenommen.
INVITATION_EXPIRED Die Einladung ist abgelaufen.
ACCESS_GRANTED Der Nutzer hat eine Einladung angenommen und hat Zugriff auf die Play Console.
ACCESS_EXPIRED Der Kontozugriff ist abgelaufen.

DeveloperLevelPermission

Eine Berechtigung, die auf Ebene des Entwicklerkontos erteilt wird.

Enums
DEVELOPER_LEVEL_PERMISSION_UNSPECIFIED Unbekannte oder nicht angegebene Berechtigung.
CAN_SEE_ALL_APPS

App-Informationen ansehen und Bulk-Berichte herunterladen (schreibgeschützt) Verworfen: Prüfen Sie CAN_VIEW_NON_FINANCIAL_DATA_GLOBAL.

CAN_VIEW_FINANCIAL_DATA_GLOBAL Finanzdaten, Bestellungen und Antworten aus der Kündigungsumfrage ansehen
CAN_MANAGE_PERMISSIONS_GLOBAL Administrator (alle Berechtigungen)
CAN_EDIT_GAMES_GLOBAL Nutzer mit dieser Berechtigung können Projekte für Play Games-Dienste bearbeiten.
CAN_PUBLISH_GAMES_GLOBAL Projekte für Play Games-Dienste veröffentlichen
CAN_REPLY_TO_REVIEWS_GLOBAL Rezensionen.Auf Rezensionen antworten.
CAN_MANAGE_PUBLIC_APKS_GLOBAL Produktionsversionen veröffentlichen, Geräte ausschließen und App-Signatur von Google Play verwenden
CAN_MANAGE_TRACK_APKS_GLOBAL Release in Test-Tracks
CAN_MANAGE_TRACK_USERS_GLOBAL Test-Tracks verwalten und Testerlisten bearbeiten
CAN_MANAGE_PUBLIC_LISTING_GLOBAL App-Präsenz im Play Store verwalten
CAN_MANAGE_DRAFT_APPS_GLOBAL App-Entwürfe erstellen, bearbeiten und löschen
CAN_CREATE_MANAGED_PLAY_APPS_GLOBAL Private Apps für Ihre Organisation erstellen und veröffentlichen
CAN_CHANGE_MANAGED_PLAY_SETTING_GLOBAL Sie können auswählen, ob Apps öffentlich oder nur für Ihre Organisation zugänglich sind.
CAN_MANAGE_ORDERS_GLOBAL Bestellungen und Abos verwalten
CAN_MANAGE_APP_CONTENT_GLOBAL Richtlinienbezogene Seiten für alle Apps des Entwicklers verwalten.
CAN_VIEW_NON_FINANCIAL_DATA_GLOBAL App-Informationen ansehen und Bulk-Berichte herunterladen (schreibgeschützt)
CAN_VIEW_APP_QUALITY_GLOBAL App-Qualitätsinformationen für alle Apps des Entwicklers ansehen.

Methoden

create

Einem Nutzer Zugriff auf das angegebene Entwicklerkonto gewähren.

delete

Entzieht dem Nutzer jeglichen Zugriff auf das angegebene Entwicklerkonto.

list

Listet alle Nutzer mit Zugriff auf ein Entwicklerkonto auf.

patch

Aktualisiert den Zugriff des Nutzers auf das Entwicklerkonto.

Fehlercodes

Die Vorgänge dieser Ressource geben die folgenden HTTP-Fehlercodes zurück:

Fehlercode Grund Beschreibung Auflösung
400 invalidValue In der Anfrage wurde ein ungültiger Wert angegeben. Dieser Fehler wird häufig zurückgegeben, wenn das Kauf-Token fehlerhaft oder ungültig ist. Korrigieren Sie den ungültigen Feldwert im Anfragetext oder in den Parametern anhand der API-Referenz.
400 required In der Anfrage fehlt ein erforderliches Feld oder ein erforderlicher Parameter. In der API-Dokumentation finden Sie Informationen dazu, ob alle Pflichtfelder und ‑parameter enthalten sind.
403 userInsufficientPermission Der Nutzer hat nicht die erforderlichen Berechtigungen, um den angeforderten Vorgang auszuführen. Prüfen Sie, ob der authentifizierte Nutzer die erforderlichen Berechtigungen in der Google Play Console hat. Weitere Informationen finden Sie unter Dienstkonto verwenden.
404 notFound Die angeforderte Ressource wurde nicht gefunden. Prüfen Sie, ob die Kennzeichnungen (z.B. Kauf-Token, Paketname, Produkt-ID, Abo-ID) korrekt sind.
409 concurrentUpdate Es wurde versucht, ein Objekt zu aktualisieren, das gleichzeitig aktualisiert wird. Wiederholen Sie die Anfrage mit exponentiellem Backoff. Vermeiden Sie gleichzeitige Änderungen an derselben Ressource.
5xx Generic error Allgemeiner Fehler auf dem Google Play-Server. Wiederholen Sie Ihre Anfrage.

Wenn das Problem weiterhin besteht, wenden Sie sich an Ihren Google Play-Kundenbetreuer oder senden Sie eine Supportanfrage. Prüfen Sie im Play-Status-Dashboard, ob bekannte Ausfälle vorliegen.