orgContact リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。
組織の連絡先を表します。 組織の連絡先は、組織の管理者によって管理され、 個人の連絡先とは異なります。 また、組織の連絡先は、オンプレミスのディレクトリまたはExchange Onlineから同期され、Microsoft Graphでは読み取り専用です。
directoryObject から継承します。
このリソースは、デルタ関数を提供することによって、増分の追加、削除、および更新を追跡するためのデルタ クエリの使用をサポートしています。 このリソースは、他のプロパティを渡すことができるオープン型です。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| 組織の連絡先 | ||
| 組織の連絡先を一覧表示する | orgContact コレクション | 組織の連絡先のプロパティを一覧表示します。 |
| 組織の連絡先を取得する | orgContact | orgContact オブジェクトのプロパティとリレーションシップを読み取ります。 |
| 組織階層 | ||
| マネージャーを取得する | directoryObject | 連絡先のマネージャーを取得します。 |
| transitiveReports を取得する | 整数 | 推移的なReports ナビゲーション プロパティから、組織の連絡先の推移的なレポートの数を取得します。 |
| List directReports | directoryObject collection | 連絡先の直属のレポートを一覧表示します。 |
| memberOf を一覧表示する | directoryObject コレクション | memberOf オブジェクト コレクションを取得します。 |
| checkMemberGroups | String コレクション | グループ メンバーシップを確認します。 |
| getMemberGroups | String コレクション | 指定した連絡先がメンバーであるすべてのグループを返します。 |
| checkMemberObjects | String collection | グループ、管理単位、ディレクトリ ロールのメンバーシップを確認します。 |
| getMemberObjects | String collection | 連絡先がメンバーであるグループ、管理単位、ディレクトリ ロールの一覧を取得します。 |
プロパティ
重要
$filter および $search クエリ パラメーターの具体的な使用方法は、ConsistencyLevel ヘッダーの設定を eventual と $count に使用する場合にのみサポートされます。 詳細については、「Azure AD ディレクトリ オブジェクトの詳細クエリ機能」を参照してください。
| プロパティ | 種類 | 説明 |
|---|---|---|
| アドレス | physicalOfficeAddress コレクション | この組織の連絡先の住所。 現時点では、連絡先に使用できる物理アドレスは 1 つだけです。 |
| CompanyName | String | この組織の連絡先が属する会社の名前。 $filter (eq、ne、not、ge、le、in、startsWith と eq の null値) をサポートします。 |
| department | String | 連絡先が機能する部署の名前。 $filter (eq、 ne、 not、 ge、 le、 in、 startsWith と eq の null値) をサポートします。 |
| displayName | String | この組織の連絡先の表示名。 $filter (eq、ne、not、ge、le、in、startsWith、および eq の null値)、$search、および $orderBy をサポートします。 |
| givenName | String | この組織の連絡先の名。 $filter (eq、 ne、 not、 ge、 le、 in、 startsWith と eq の null値) をサポートします。 |
| id | String | この組織の連絡先の一意の識別子。 $filter (eq、ne、not、in) をサポートします。 |
| jobTitle | String | この組織の連絡先の役職。 $filter (eq、 ne、 not、 ge、 le、 in、 startsWith と eq の null値) をサポートします。 |
| String | 連絡先の SMTP アドレス ("jeff@contoso.onmicrosoft.com" など)。 $filter (eq、 ne、 not、 ge、 le、 in、 startsWith と eq の null値) をサポートします。 |
|
| mailNickname | String | この組織の連絡先の電子メール エイリアス (@記号が保留中の電子メール アドレスの一部)。 $filter (eq、ne、not、ge、le、in、startsWith と eq の null値) をサポートします。 |
| onPremisesLastSyncDateTime | DateTimeOffset | この組織の連絡先がオンプレミス AD から最後に同期された日時。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 $filter (eq、ne、not、ge、le、in) をサポートします。 |
| onPremisesProvisioningErrors | onPremisesProvisioningError コレクション | この組織の連絡先の同期プロビジョニング エラーの一覧。 $filter (eq、not) をサポートします。 |
| onPremisesSyncEnabled | Boolean | このオブジェクトがオンプレミス ディレクトリから同期されている場合は true。このオブジェクトがもともとオンプレミスのディレクトリから同期されていたが、同期されなくなり、Exchangeでマスターされている場合は false。このオブジェクトがオンプレミス ディレクトリから同期されたことがない場合は null (既定値)。 $filter (eq、 ne、 not、 in、 および eq の null 値) をサポートします。 |
| phones | phone コレクション | この組織の連絡先の電話の一覧。 電話の種類は、モバイル、ビジネス、businessFax です。 コレクションに存在できるのは、各型のうち 1 つのみです。 $filter (eq、ne、not、in) をサポートします。 |
| proxyAddresses | String collection | たとえば、"SMTP: bob@contoso.com"、"smtp: bob@sales.contoso.com" などです。 複数値プロパティのフィルター式には any 演算子が必要です。 空のコレクション (eq、le``not``ge``startsWithおよびカウント) をサポート$filterします。 |
| surname | String | この組織の連絡先の姓。 $filter (eq、ne、not、ge、le、in、startsWith および eq の null 値) をサポートします。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| directReports | directoryObject collection | 連絡先の直属のレポート。 (管理者プロパティがこの連絡先に設定されているユーザーと連絡先)。読み 取り 専用。 Null 許容型。 $expand をサポートします。 |
| manager | directoryObject | この連絡先のマネージャーであるユーザーまたは連絡先。 読み取り専用です。 $expand をサポートします。 |
| memberOf | directoryObject collection | この連絡先がメンバーであるグループ。 読み取り専用です。 Null 許容型。 $expand をサポートします。 |
| transitiveReports | directoryObject コレクション | 連絡先の推移的なレポート。 読み取り専用です。 |
JSON 表記
以下は、リソースの JSON 表記です
{
"addresses": [{"@odata.type": "microsoft.graph.physicalOfficeAddress"}],
"companyName": "string",
"department": "string",
"displayName": "string",
"givenName": "string",
"id": "string (identifier)",
"jobTitle": "string",
"mail": "string",
"mailNickname": "string",
"onPremisesLastSyncDateTime": "string (timestamp)",
"onPremisesProvisioningErrors": [{"@odata.type": "microsoft.graph.onPremisesProvisioningError"}],
"onPremisesSyncEnabled": true,
"phones": [{"@odata.type": "microsoft.graph.phone"}],
"proxyAddresses": ["string"],
"surname": "string"
}
フィードバック
フィードバックの送信と表示