リクエストされたリソース名のリストを指定することで、特定のユーザーのリストに関する情報を提供します。people/me
を使用して、認証済みのユーザーを指定します。
「personFields」が指定されていない場合、リクエストは 400 エラーを返します。
HTTP リクエスト
GET https://people.googleapis.com/v1/people:batchGet
この URL は gRPC Transcoding 構文を使用します。
クエリ パラメータ
パラメータ | |
---|---|
resourceNames[] |
必須。情報を提供するユーザーのリソース名。繰り返し可能です。URL クエリ パラメータは、
リソース名は最大 200 個です。 |
requestMask |
非推奨(代わりに 結果をユーザー フィールドのサブセットに制限するマスク。 |
personFields |
必須。フィールド マスク。各ユーザーに返されるフィールドを制限します。複数のフィールドを指定する場合は、カンマで区切ります。指定できる値は次のとおりです。
|
sources[] |
(省略可)返されるソースタイプのマスク。設定しない場合、デフォルトは |
リクエスト本文
リクエストの本文は空にする必要があります。
レスポンスの本文
成功すると、レスポンスの本文に次の構造のデータが含まれます。
リソース名によるリスト取得リクエストに対するレスポンス。
JSON 表現 |
---|
{
"responses": [
{
object ( |
フィールド | |
---|---|
responses[] |
リクエストされた各リソース名のレスポンス。 |
認可スコープ
一般公開データへのアクセスに承認は必要ありません。非公開データの場合は、次のいずれかの OAuth スコープが必要です。
https://www.googleapis.com/auth/contacts
https://www.googleapis.com/auth/contacts.readonly
https://www.googleapis.com/auth/directory.readonly
https://www.googleapis.com/auth/profile.agerange.read
https://www.googleapis.com/auth/profile.emails.read
https://www.googleapis.com/auth/profile.language.read
https://www.googleapis.com/auth/user.addresses.read
https://www.googleapis.com/auth/user.birthday.read
https://www.googleapis.com/auth/user.emails.read
https://www.googleapis.com/auth/user.gender.read
https://www.googleapis.com/auth/user.organization.read
https://www.googleapis.com/auth/user.phonenumbers.read
https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/userinfo.profile
詳しくは、承認ガイドをご覧ください。