名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
組織の連絡先を表します。 組織の連絡先は、organizationの管理者によって管理され、個人の連絡先とは異なります。 さらに、組織の連絡先はオンプレミス ディレクトリまたは Exchange Online から同期され、Microsoft Graph では読み取り専用です。
directoryObject から継承します。
このリソースは、デルタ関数を提供することによって、増分の追加、削除、および更新を追跡するためのデルタ クエリの使用をサポートしています。 このリソースは、ここに記載されているもの以外の追加のプロパティを許可するオープン型です。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| 組織の連絡先 | ||
| List | orgContact コレクション | 組織の連絡先のプロパティを一覧表示します。 |
| Get | orgContact | orgContact オブジェクトのプロパティと関係を読み取ります。 |
| Get delta | orgContact コレクション | コレクション全体を完全に読み取ることなく、新しく作成、更新、または削除された組織の連絡先を取得します。 |
| ディレクトリ オブジェクトのデルタを取得する | direcyoryObject コレクション | コレクション全体を完全に読み取ることなく、ディレクトリ オブジェクト コレクションを使用して、新しく作成、更新、または削除された組織の連絡先を取得します。 |
| 所属を一覧表示する | String collection | 連絡先がメンバーであるグループと管理単位のリストを取得します。 チェックは推移的です。 |
| 推移的な所属を一覧表示する | directoryObject コレクション | 組織の連絡先がネストされているグループを含め、組織の連絡先がメンバーであるグループを一覧表示します。 |
| メンバー グループをチェックする | String collection | グループの一覧で組織の連絡先のメンバーシップを確認します。 チェックは推移的です。 |
| メンバー グループを取得する | String collection | 組織の連絡先がメンバーであるすべてのグループを返します。 チェックは推移的です。 |
| メンバー オブジェクトを確認する | String collection | グループ、ディレクトリ ロール、または管理単位オブジェクトの一覧で、組織の連絡先のメンバーシップを確認します。 |
| メンバー オブジェクトを取得する | String コレクション | 組織の連絡先がメンバーであるすべてのグループ、管理単位、およびディレクトリ ロールを返します。 チェックは推移的です。 |
| サービスのプロビジョニングを再試行する | なし | orgContact サービスのプロビジョニングを再試行します。 |
| 推移レポートの取得 | 整数 | transitiveReports ナビゲーション プロパティから organization 連絡先の推移レポートの数を取得します。 |
| オンプレミスの同期動作 (権限のソース) | ||
| Get | onPremisesSyncBehavior | 連絡先オブジェクトの権限ソース (SOA) がクラウドまたはオンプレミスの Active Directory であるかどうかを確認します。 |
| Update | onPremisesSyncBehavior | 連絡先オブジェクトの権限ソース (SOA) をクラウドまたはオンプレミスの Active Directory に更新します。 |
| 組織階層 | ||
| Get manager | directoryObject | 連絡先の上司を取得します。 |
| 直属の部下を一覧表示する | directoryObject コレクション | 連絡先の直属の部下を一覧表示します。 |
プロパティ
重要
$filter および $search クエリ パラメーターの具体的な使用方法は、ConsistencyLevel ヘッダーの設定を eventual と $count に使用する場合にのみサポートされます。 詳細については、「ディレクトリ オブジェクトの詳細クエリ機能」を参照してください。
| プロパティ | 型 | 説明 |
|---|---|---|
| addresses | physicalOfficeAddress コレクション | この組織連絡先の郵便番号。 現時点では、連絡先は 1 つの物理的な住所しか持つことができません。 |
| CompanyName | String | この組織連絡先が属する会社の名前。
$filter (null値の eq、ne、not、ge、le、in、startsWith、eq) をサポートします。 |
| department | String | 連絡先が勤務している部門の名前。
$filter (null値の eq、ne、not、ge、le、in、startsWith、eq) をサポートします。 |
| displayName | 文字列 | この組織連絡先の表示名。 最大文字数は 256 文字です。
$filter (eq、ne、not、ge、le、in、startsWith、およびnull値のeq)、$search、および$orderbyをサポートします。 |
| givenName | String | この組織の連絡先の名。
$filter (null値の eq、ne、not、ge、le、in、startsWith、eq) をサポートします。 |
| id | 文字列 | この組織の連絡先の一意識別子。
$filter (eq、ne、not、in) をサポートします。 |
| jobTitle | String | この組織の連絡先の役職。
$filter (null値の eq、ne、not、ge、le、in、startsWith、eq) をサポートします。 |
| String | 連絡先の SMTP アドレス (例: "jeff@contoso.com")。
$filter (null値の eq、ne、not、ge、le、in、startsWith、eq) をサポートします。 |
|
| mailNickname | 文字列 | この組織の連絡先の Email エイリアス (@ 記号の前の電子メール アドレスの一部)。
$filter (null値の 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 コレクション | この組織の連絡先の同期プロビジョニング エラーの一覧。
$filter (eq、カテゴリおよび propertyCausingError のnot)、/$count eq 0、/$count ne 0 をサポートします。 |
| onPremisesSyncEnabled | Boolean | このオブジェクトがオンプレミスのディレクトリから同期されている場合は true。このオブジェクトがもともとオンプレミス ディレクトリから同期されていたが、同期されなくなり、Exchange でマスターされた場合は false。このオブジェクトがオンプレミスのディレクトリから同期されたことがない場合は null (既定値)。 $filter (null値の eq、ne、not、in、eq) をサポートします。 |
| phones | phone コレクション | この組織の連絡先の電話のリスト。 電話の種類は、携帯電話、ビジネス、ビジネス用 FAX です。 コレクションには、各型の 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 | この組織連絡先の姓。
$filter (null値の eq、ne、not、ge、le、in、startsWith、eq) をサポート |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| directReports | directoryObject コレクション | 連絡先の直属の部下。 (上司プロパティがこの連絡先に設定されているユーザーおよび連絡先)。読み取り専用です。 Null 許容型。
$expand をサポートします。 |
| manager | directoryObject | この連絡先の上司であるユーザーまたは連絡先。 読み取り専用です。
ID による$expandと$filter (eq) をサポートします。 |
| memberOf | directoryObject コレクション | この連絡先がメンバーになっているグループ。 読み取り専用です。 Null 許容型。
$expand をサポートします。 |
| onPremisesSyncBehavior | onPremisesSyncBehavior | クラウドとオンプレミスの Active Directory との間の orgContact の同期の状態を示します。 高度なクエリ機能 ($filter=onPremisesSyncBehavior/isCloudManaged eq true&$count=true など) を持つ$filterのみをサポートします。 |
| 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"
}