Method: accounts.revokeToken

Membatalkan token pengguna dari Penyedia Identitas (IdP). Hal ini dilakukan dengan memberikan kredensial IdP secara manual, dan jenis token untuk pencabutan.

Kunci API diperlukan dalam permintaan untuk mengidentifikasi project Google Cloud.

Permintaan HTTP

POST https://identitytoolkit.googleapis.com/v2/accounts:revokeToken

URL menggunakan sintaks gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "providerId": string,
  "tokenType": enum (TokenType),
  "token": string,
  "idToken": string,
  "tenantId": string,
  "redirectUri": string
}
Kolom
providerId

string

Wajib. Penyedia idp untuk token. Saat ini hanya mendukung Apple IdP. Formatnya harus "apple.com".
tokenType

enum (TokenType)

Wajib. Jenis token yang akan dicabut.
token

string

Wajib. Token yang akan dicabut. Jika authorization_code diteruskan, API akan menukarkan kode dengan token akses terlebih dahulu, lalu mencabut token yang ditukar.
idToken

string

Wajib. Token ID Identity Platform yang valid untuk menautkan akun. Jika ada permintaan pencabutan token yang berhasil di akun dan tidak ada token yang dibuat setelah pencabutan, permintaan duplikat akan diabaikan dan segera ditampilkan.
tenantId

string

ID tenant Identity Platform tempat pengguna login. Jika tidak ditetapkan, pengguna akan login ke project Identity Platform default.
redirectUri

string

URI pengalihan yang diberikan dalam permintaan otorisasi awal yang dibuat oleh klien ke IdP. URI harus menggunakan protokol HTTPS, menyertakan nama domain, dan tidak boleh berisi alamat IP atau localhost. Wajib diisi jika tokenType adalah CODE.

Isi respons

Jika berhasil, isi respons akan kosong.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/identitytoolkit
  • https://www.googleapis.com/auth/cloud-platform

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

TokenType

Jenis token yang akan dicabut.

Enum
TOKEN_TYPE_UNSPECIFIED Nilai default, jangan gunakan.
REFRESH_TOKEN Jenis token adalah refreshToken.
ACCESS_TOKEN Jenis token adalah accessToken.
CODE Jenis token adalah authorization_code.