orgContact リソースの種類

[アーティクル]
05/14/2023

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

組織の連絡先を表します。組織の連絡先は、organizationの管理者によって管理され、個人の連絡先とは異なります。さらに、組織の連絡先は、オンプレミスのディレクトリまたはExchange Onlineから同期され、Microsoft Graph では読み取り専用です。

directoryObject から継承します。

このリソースは、デルタ関数を提供することによって、増分の追加、削除、および更新を追跡するためのデルタクエリの使用をサポートしています。このリソースは、他のプロパティを渡すことができるオープン型です。

メソッド

メソッド	戻り値の型	説明
組織の連絡先
組織の連絡先を一覧表示する	orgContact コレクション	組織の連絡先のプロパティを一覧表示します。
組織の連絡先を取得する	orgContact	orgContact オブジェクトのプロパティとリレーションシップを読み取ります。
組織階層
Get manager	directoryObject	連絡先のマネージャーを取得します。
Get transitiveReports	整数	transitiveReports ナビゲーションプロパティから、organization連絡先の推移的なレポートの数を取得します。
List directReports	directoryObject コレクション	連絡先の直接レポートを一覧表示します。
List memberOf	directoryObject コレクション	memberOf オブジェクトコレクションを取得します。
checkMemberGroups	String collection	グループメンバーシップを確認します。
getMemberGroups	String collection	指定した連絡先がメンバーであるすべてのグループを返します。
checkMemberObjects	String collection	グループ、管理単位、ディレクトリロールのメンバーシップを確認します。
getMemberObjects	String collection	連絡先がメンバーであるグループ、管理単位、ディレクトリロールの一覧を取得します。

プロパティ

重要

$filter および $search クエリパラメーターの具体的な使用方法は、ConsistencyLevel ヘッダーの設定を eventual と $count に使用する場合にのみサポートされます。詳細については、「ディレクトリオブジェクトの詳細クエリ機能」を参照してください。

プロパティ	型	説明
アドレス	physicalOfficeAddress コレクション	この組織の連絡先の住所を郵送します。現時点では、連絡先は 1 つの物理アドレスのみを持つことができます。
CompanyName	String	この組織の連絡先が属している会社の名前。 (`eq`、`nenotge`、`instartsWithle`および `eq` の値) を`null`サポートします。`$filter`
department	String	連絡先が機能する部署の名前。 (`eq`、`nenotge`、`instartsWithle`および `eq` の値) を`null`サポートします。`$filter`
displayName	String	この組織の連絡先の表示名。 `$filter` (`eq`、`negenot`、`le`、`instartsWith`、および `eq` の`null`値)`$search`、およびをサポートします。`$orderby`
givenName	String	この組織の連絡先の名。 (`eq`、`nenotge`、`instartsWithle`および `eq` の値) を`null`サポートします。`$filter`
id	String	この組織の連絡先の一意の識別子。 `$filter` (`eq`、`ne`、`not`、`in`) をサポートします。
jobTitle	String	この組織の連絡先の役職。 (`eq`、`nenotge`、`instartsWithle`および `eq` の値) を`null`サポートします。`$filter`
mail	String	連絡先の SMTP アドレス ("" などjeff@contoso.com)。 (`eq`、`nenotge`、`instartsWithle`および `eq` の値) を`null`サポートします。`$filter`
mailNickname	String	Emailこの組織の連絡先のエイリアス (電子メールアドレスの一部が @ 記号より前に保留されています)。 (`eq`、`nenotge`、`instartsWithle`および `eq` の値) を`null`サポートします。`$filter`
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`カテゴリと propertyCausingError の場合)`/$count eq 0`、、`/$count ne 0`。
onPremisesSyncEnabled	Boolean	このオブジェクトがオンプレミスディレクトリから同期されている場合は true。このオブジェクトがもともとオンプレミスのディレクトリから同期されていたが、同期されなくなり、Exchange でマスターされるようになった場合は false。このオブジェクトがオンプレミスディレクトリから同期されていない場合は null (既定値)。 (`eq`、`neinnot`、および `eq` の値) を`null`サポートします。`$filter`
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	この組織の連絡先の姓。 (`eq`、`nenotge`、`le`、`instartsWith`、および `eq` の値) を`null`サポートします。`$filter`

リレーションシップ

リレーションシップ	型	説明
directReports	directoryObject コレクション	連絡先の直属部下。 (マネージャープロパティがこの連絡先に設定されているユーザーと連絡先)。読み取り専用。 Null 許容型。 `$expand` をサポートします。
manager	directoryObject	この連絡先のマネージャーであるユーザーまたは連絡先。読み取り専用です。 ID でおよび `$filter` (`eq`) をサポートします`$expand`。
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"
}