Method: projects.tenants.accounts.lookup

Mendapatkan informasi akun untuk semua akun yang cocok. Untuk permintaan pengguna akhir, mengambil akun pengguna akhir. Untuk permintaan admin dengan kredensial Google OAuth 2.0, mengambil satu atau beberapa akun dengan kriteria yang cocok.

Permintaan HTTP

POST https://identitytoolkit.googleapis.com/v1/projects/{targetProjectId}/tenants/{tenantId}/accounts:lookup

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
targetProjectId

string

ID project Google Cloud yang menjadi milik akun atau tenant Identity Platform yang ditentukan oleh tenantId. Hanya boleh ditentukan oleh permintaan terautentikasi yang memiliki kredensial Google OAuth 2.0 dengan izin yang sesuai.

Otorisasi memerlukan izin IAM berikut pada resource targetProjectId yang ditentukan:

  • firebaseauth.users.get
tenantId

string

ID tenant tempat akun berada. Hanya boleh ditentukan oleh permintaan terautentikasi dari developer.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "idToken": string,
  "localId": [
    string
  ],
  "email": [
    string
  ],
  "delegatedProjectNumber": string,
  "phoneNumber": [
    string
  ],
  "federatedUserId": [
    {
      object (FederatedUserIdentifier)
    }
  ],
  "initialEmail": [
    string
  ]
}
Kolom
idToken

string

Token ID Identity Platform dari akun yang akan diambil. Wajib ditentukan untuk permintaan dari pengguna akhir.
localId[]

string

ID satu atau beberapa akun yang akan diambil. Hanya boleh ditentukan oleh permintaan terautentikasi yang memiliki kredensial Google OAuth 2.0 dengan izin yang sesuai.
email[]

string

Alamat email satu atau beberapa akun yang akan diambil. Panjang email harus kurang dari 256 karakter dan dalam format name@domain.tld. Email juga harus cocok dengan produksi addr-spec RFC 822. Hanya boleh ditentukan oleh permintaan terautentikasi dari developer.
delegatedProjectNumber
(deprecated)

string (int64 format)
phoneNumber[]

string

Nomor telepon satu atau beberapa akun yang akan diambil. Hanya boleh ditentukan oleh permintaan terautentikasi dari developer dan harus dalam format E.164, misalnya, +15555555555.
federatedUserId[]

object (FederatedUserIdentifier)
initialEmail[]

string

Email awal dari satu atau beberapa akun yang akan diambil. Panjang email harus kurang dari 256 karakter dan dalam format name@domain.tld. Email juga harus cocok dengan produksi addr-spec RFC 822. Hanya boleh ditentukan oleh permintaan terautentikasi dari developer.

Isi respons

Jika berhasil, isi respons akan berisi instance GetAccountInfoResponse.

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.