Method: projects.getAuthorization
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ruft die Autorisierungsinformationen für Bereitstellungen in einem bestimmten Projekt ab.
HTTP-Anfrage
GET https://gsuiteaddons.googleapis.com/v1/{name=projects/*/authorization}
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
name |
string
Erforderlich. Name des Projekts, für das die Autorisierungsinformationen für das Google Workspace-Add-on abgerufen werden sollen. Beispiel: projects/my_project/authorization.
Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:
gsuiteaddons.authorizations.get
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Die Autorisierungsinformationen, die beim Aufrufen von Bereitstellungsendpunkten verwendet werden.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"name": string,
"serviceAccountEmail": string,
"oauthClientId": string
} |
| Felder |
name |
string
Der kanonische vollständige Name dieser Ressource. Beispiel: projects/123/authorization
|
serviceAccountEmail |
string
Die E-Mail-Adresse des Dienstkontos, das zum Authentifizieren von Anfragen an Add-on-Callback-Endpunkte verwendet wird.
|
oauthClientId |
string
Die OAuth-Client-ID, die zum Abrufen von OAuth-Zugriffstokens für einen Nutzer im Namen des Add-ons verwendet wird.
|
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/cloud-platform
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-04-22 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-04-22 (UTC)."],[[["\u003cp\u003eRetrieves Google Workspace Add-on authorization details for a specific project.\u003c/p\u003e\n"],["\u003cp\u003eRequires project name as a path parameter and an empty request body.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes authorization name, service account email, and OAuth client ID.\u003c/p\u003e\n"],["\u003cp\u003eNeeds \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],["This document details retrieving authorization information for Google Workspace add-on deployments within a project. It uses a `GET` HTTP request to a specific URL containing the project name. The request body must be empty. The response, formatted in JSON, includes the project's canonical name, service account email, and OAuth client ID. Authorization requires a `gsuiteaddons.authorizations.get` IAM permission and the `https://www.googleapis.com/auth/cloud-platform` OAuth scope.\n"],null,["# Method: projects.getAuthorization\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.Authorization.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nGets the authorization information for deployments in a given project.\n\n### HTTP request\n\n`GET https://gsuiteaddons.googleapis.com/v1/{name=projects/*/authorization}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. Name of the project for which to get the Google Workspace add-on authorization information. Example: `projects/my_project/authorization`. Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `name`: - `gsuiteaddons.authorizations.get` |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe authorization information used when invoking deployment endpoints.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"serviceAccountEmail\": string, \"oauthClientId\": string } ``` |\n\n| Fields ||\n|-----------------------|---------------------------------------------------------------------------------------------------------------|\n| `name` | `string` The canonical full name of this resource. Example: `projects/123/authorization` |\n| `serviceAccountEmail` | `string` The email address of the service account used to authenticate requests to add-on callback endpoints. |\n| `oauthClientId` | `string` The OAuth client ID used to obtain OAuth access tokens for a user on the add-on's behalf. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
