名前空間: microsoft.graph
組織の連絡先を表します。 組織の連絡先は、organizationの管理者によって管理され、個人の連絡先とは異なります。 さらに、組織の連絡先は、オンプレミスのディレクトリまたはExchange Onlineから同期され、Microsoft Graph では読み取り専用です。
directoryObject から継承します。
このリソースは、デルタ関数を提供することによって、増分の追加、削除、および更新を追跡するためのデルタ クエリの使用をサポートしています。 このリソースは、他のプロパティを渡すことができるオープン型です。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| 組織の連絡先 | ||
| List | orgContact | 組織の連絡先のプロパティを一覧表示します。 |
| Get | orgContact | 組織の連絡先のプロパティとリレーションシップを読み取る。 |
| Get delta | orgContact コレクション | コレクション全体の完全な読み取りを実行することなく、新しく作成、更新、または削除された組織の連絡先を取得します。 |
| ディレクトリ オブジェクトのデルタを取得する | direcyoryObject コレクション | ディレクトリ オブジェクト コレクションを使用して、新しく作成、更新、または削除された組織の連絡先を取得します。コレクション全体を完全に読み取る必要はありません。 |
| 所属を一覧表示する | String collection | 連絡先がメンバーであるグループと管理単位の一覧を取得します。 チェックは推移的です。 |
| 推移的なメンバーを一覧表示する | directoryObject コレクション | 組織の連絡先が入れ子になっているグループなど、組織の連絡先がメンバーになっているグループを一覧表示します。 |
| メンバー グループをチェックする | String collection | グループの一覧で組織の連絡先のメンバーシップを確認します。 チェックは推移的です。 |
| メンバー グループを取得する | String collection | 組織の連絡先がメンバーであるすべてのグループを返します。 チェックは推移的です。 |
| メンバー オブジェクトを確認する | String collection | グループ、ディレクトリ ロール、または管理単位オブジェクトの一覧で、組織の連絡先のメンバーシップを確認します。 |
| メンバー オブジェクトを取得する | String collection | 組織の連絡先がメンバーであるすべてのグループ、管理単位、ディレクトリ ロールを返します。 チェックは推移的です。 |
| サービスのプロビジョニングを再試行する | なし | orgContact サービス プロビジョニングを再試行します。 |
| 組織階層 | ||
| 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 | この組織の連絡先の表示名。 最大文字数は 256 文字です。
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 | Emailこの組織の連絡先のエイリアス (電子メール アドレスの一部が @ 記号より前に保留されています)。
null値の$filter (eq、ne、not、ge、le、in、startsWith、eq) をサポートします。 |
| serviceProvisioningErrors | serviceProvisioningError コレクション | 組織の連絡先オブジェクトからのプロパティまたはリンクに関する一時的でないサービス固有のエラーを記述するフェデレーション サービスによって発行されたエラー。 $filter (isResolved および serviceInstance の eq、not) をサポートします。 |
| onPremisesLastSyncDateTime | DateTimeOffset | この組織の連絡先がオンプレミス AD から最後に同期された日時。 この日付と時刻の情報は 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 つだけです。 |
| 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) をサポートします。 |
| 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 をサポートします。 |
| transitiveMemberOf | directoryObject コレクション | この連絡先がのメンバーであることをグループします。これには、連絡先が入れ子になっているグループが含まれます。 読み取り専用です。 Null 許容型。 |
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"
}