Method: people.searchDirectoryPeople

認証されたユーザーのドメイン ディレクトリ内にある、検索クエリに一致するドメイン プロフィールとドメインの連絡先のリストを提供します。

HTTP リクエスト

GET https://people.googleapis.com/v1/people:searchDirectoryPeople

この URL は gRPC Transcoding 構文を使用します。

クエリ パラメータ

パラメータ
query

string

必須。人のフィールドに一致するクエリを接頭辞にします。照合するフィールドの決定に readMask を使用しません。

readMask

string (FieldMask format)

必須。各人物のどのフィールドが返されるかを制限するフィールド マスク。複数のフィールドを指定する場合は、フィールドをカンマで区切ります。指定できる値は次のとおりです。

  • addresses
  • ageRanges
  • 伝記
  • 誕生日
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • イベント
  • externalIds
  • 性別
  • imClients
  • 関心
  • locales
  • 開催地
  • メンバーシップ
  • メタデータ
  • miscKeywords
  • names
  • ニックネーム
  • 職業
  • organizations
  • phoneNumbers
  • 写真
  • 関係
  • sipAddresses
  • skills
  • urls
  • userDefined
sources[]

enum (DirectorySourceType)

必須。返されるディレクトリ ソース。

mergeSources[]

enum (DirectoryMergeSourceType)

省略可。メールアドレスや電話番号などの確認済みの結合キーを介して接続されている場合、ディレクトリ ソースに統合する追加データ。

pageSize

integer

省略可。回答に含める人数。有効な値は 1 ~ 500 です。設定しない場合、または 0 に設定した場合、デフォルトは 100 です。

pageToken

string

省略可。前のレスポンス nextPageToken から受け取ったページトークン。これを指定して、後続のページを取得します。

ページ分割の際には、[people.searchDirectoryPeople][google.people.v1.SearchDirectoryPeople] に指定する他のすべてのパラメータは、ページトークンを提供した最初の呼び出しと一致する必要があります。

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

認証されたユーザーのドメイン ディレクトリ内で、指定されたクエリに一致するユーザーに対するリクエストに対するレスポンス。

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現
{
  "people": [
    {
      object (Person)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
フィールド
people[]

object (Person)

クエリに一致するドメイン ディレクトリ内のユーザーのリスト。

nextPageToken

string

次のページを取得するために pageToken として送信できるトークン。このフィールドを省略すると、後続のページはなくなります。

totalSize

integer

ページ分けなしのリスト内のアイテムの合計数。

承認スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/directory.readonly

詳しくは、承認ガイドをご覧ください。