orgContact リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph の /beta
バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
組織の連絡先を表します。 組織の連絡先は、組織の管理者によって管理され、 個人の連絡先とは異なります。 さらに、組織の連絡先は、オンプレミスのディレクトリまたは Exchange Online から同期され、Microsoft Graph では読み取り専用です。
directoryObject から継承します。
このリソースは、デルタ関数を提供することによって、増分の追加、削除、および更新を追跡するためのデルタ クエリの使用をサポートしています。 このリソースは、他のプロパティを渡すことができるオープン型です。
メソッド
メソッド | 戻り値の型 | 説明 |
---|---|---|
組織の連絡先 | ||
List | orgContact コレクション | 組織の連絡先のプロパティを一覧表示します。 |
Get | orgContact | orgContact オブジェクトのプロパティとリレーションシップを読み取ります。 |
Get delta | orgContact コレクション | コレクション全体の完全な読み取りを実行することなく、新しく作成、更新、または削除された組織の連絡先を取得します。 |
ディレクトリ オブジェクトのデルタを取得する | direcyoryObject コレクション | ディレクトリ オブジェクト コレクションを使用して、新しく作成、更新、または削除された組織の連絡先を取得します。コレクション全体を完全に読み取る必要はありません。 |
所属を一覧表示する | String collection | 連絡先がメンバーであるグループと管理単位の一覧を取得します。 チェックは推移的です。 |
推移的な所属を一覧表示する | directoryObject コレクション | 組織の連絡先が入れ子になっているグループなど、組織の連絡先がメンバーになっているグループを一覧表示します。 |
メンバー グループをチェックする | String collection | グループの一覧で組織の連絡先のメンバーシップを確認します。 チェックは推移的です。 |
メンバー グループを取得する | String collection | 組織の連絡先がメンバーであるすべてのグループを返します。 チェックは推移的です。 |
メンバー オブジェクトを確認する | String collection | グループ、ディレクトリ ロール、または管理単位オブジェクトの一覧で、組織の連絡先のメンバーシップを確認します。 |
メンバー オブジェクトを取得する | String collection | 組織の連絡先がメンバーであるすべてのグループ、管理単位、ディレクトリ ロールを返します。 チェックは推移的です。 |
サービスのプロビジョニングを再試行する | なし | orgContact サービス プロビジョニングを再試行します。 |
推移的なレポートを取得する | 整数 | TransitiveReports ナビゲーション プロパティから、組織の連絡先の推移的なレポートの数を取得します。 |
組織階層 | ||
Get manager | directoryObject | 連絡先のマネージャーを取得します。 |
直属の部下を一覧表示する | directoryObject コレクション | 連絡先の直接レポートを一覧表示します。 |
プロパティ
重要
$filter
および $search
クエリ パラメーターの具体的な使用方法は、ConsistencyLevel ヘッダーの設定を eventual
と $count
に使用する場合にのみサポートされます。 詳細については、「ディレクトリ オブジェクトの詳細クエリ機能」を参照してください。
プロパティ | 型 | 説明 |
---|---|---|
アドレス | physicalOfficeAddress コレクション | この組織の連絡先の住所を郵送します。 現時点では、連絡先は 1 つの物理アドレスのみを持つことができます。 |
CompanyName | String | この組織の連絡先が属している会社の名前。
null 値の$filter (eq 、ne 、not 、ge 、le 、in 、startsWith 、eq ) をサポートします。 |
department | String | 連絡先が機能する部署の名前。
null 値の$filter (eq 、ne 、not 、ge 、le 、in 、startsWith 、eq ) をサポートします。 |
displayName | String | この組織の連絡先の表示名。
null 値、$search 、$orderby の$filter (eq 、ne 、not 、ge 、le 、in 、startsWith 、およびeq をサポートします。 |
givenName | String | この組織の連絡先の名。
null 値の$filter (eq 、ne 、not 、ge 、le 、in 、startsWith 、eq ) をサポートします。 |
id | String | この組織の連絡先の一意の識別子。
$filter (eq 、ne 、not 、in ) をサポートします。 |
jobTitle | String | この組織の連絡先の役職。
null 値の$filter (eq 、ne 、not 、ge 、le 、in 、startsWith 、eq ) をサポートします。 |
String | 連絡先の SMTP アドレス ("jeff@contoso.com" など)。
null 値の$filter (eq 、ne 、not 、ge 、le 、in 、startsWith 、eq ) をサポートします。 |
|
mailNickname | String | この組織の連絡先のメール エイリアス (電子メール アドレスの一部が @ 記号より前に保留されています)。
null 値の$filter (eq 、ne 、not 、ge 、le 、in 、startsWith 、eq ) をサポートします。 |
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 コレクション | この組織の連絡先の同期プロビジョニング エラーの一覧。
カテゴリと propertyCausingError の$filter (eq 、not )、/$count eq 0 、/$count ne 0 をサポートします。 |
onPremisesSyncEnabled | Boolean | このオブジェクトがオンプレミス ディレクトリから同期されている場合は true。このオブジェクトがもともとオンプレミスのディレクトリから同期されていたが、同期されなくなり、Exchange でマスターされるようになった場合は false。このオブジェクトがオンプレミス ディレクトリから同期されていない場合は null (既定値)。 null 値の$filter (eq 、ne 、not 、in 、およびeq ) をサポートします。 |
phones | phone コレクション | この組織の連絡先の電話の一覧。 電話の種類は、モバイル、ビジネス、businessFax のいずれかです。 コレクション内に存在できるのは、各型の 1 つだけです。
$filter (eq 、ne 、not 、in ) をサポートします。 |
proxyAddresses | String collection | たとえば、"SMTP: bob@contoso.com"、"smtp: bob@sales.contoso.com" などです。 複数値プロパティのフィルター式には any 演算子が必要です。
$filter (eq 、not 、ge 、le 、startsWith 、/$count eq 0 、/$count ne 0 ) をサポートします。 |
serviceProvisioningErrors | serviceProvisioningError コレクション | orgContact オブジェクトからのプロパティまたはリンクに関する一時的でないサービス固有のエラーを記述するフェデレーション サービスによって発行されたエラー。 $filter (isResolved および serviceInstance の eq 、not ) をサポートします。 |
surname | String | この組織の連絡先の姓。
null 値の$filter (eq 、ne 、not 、ge 、le 、in 、startsWith 、eq ) をサポートします。 |
リレーションシップ
リレーションシップ | 型 | 説明 |
---|---|---|
directReports | directoryObject コレクション | 連絡先の直属部下。 (マネージャー プロパティがこの連絡先に設定されているユーザーと連絡先)。読み取り専用。 Null 許容型です。
$expand をサポートします。 |
manager | directoryObject | この連絡先のマネージャーであるユーザーまたは連絡先。 読み取り専用です。 id で $expand と $filter (eq ) をサポートします。 |
memberOf | directoryObject コレクション | この連絡先がメンバーであるグループ。 読み取り専用です。 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"],
"serviceProvisioningErrors": [{"@odata.type": "microsoft.graph.serviceProvisioningXmlError"}],
"surname": "string"
}