orgContact リソースの種類

[アーティクル]
04/09/2024

名前空間: microsoft.graph

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

directoryObject から継承します。

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

メソッド

メソッド	戻り値の型	説明
組織の連絡先
組織の連絡先を一覧表示する	orgContact	組織の連絡先のプロパティを一覧表示します。
組織の連絡先を取得する	orgContact	組織の連絡先のプロパティとリレーションシップを読み取る。
組織階層
Get manager	directoryObject	組織の連絡先のマネージャーを取得します。
List directReports	directoryObject コレクション	組織の連絡先の直接レポートを一覧表示します。
List memberOf	directoryObject コレクション	組織の連絡先がメンバーであるグループを一覧表示します。
List transitiveMemberOf	directoryObject コレクション	組織の連絡先が入れ子になっているグループなど、組織の連絡先がメンバーになっているグループを一覧表示します。
checkMemberGroups	String collection	グループメンバーシップを確認します。
getMemberGroups	String collection	指定した組織の連絡先がメンバーであるすべてのグループを返します。
getMemberObjects	String collection	組織の連絡先がメンバーである directoryObjects の一覧を返します。

プロパティ

重要

$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	文字列	この組織の連絡先の一意の識別子。 `$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`
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 コレクション	この組織の連絡先の同期プロビジョニングエラーの一覧。サポート `$filter` (`eq`、`not`カテゴリと propertyCausingError の場合)`/$count eq 0`、、`/$count ne 0`。
onPremisesSyncEnabled	Boolean	`true` このオブジェクトがオンプレミスディレクトリから同期されている場合。 `false` このオブジェクトは、もともとオンプレミスのディレクトリから同期されていたが、同期されなくなり、Exchange でマスターされている場合。 `null` このオブジェクトがオンプレミスディレクトリから同期されていない場合 (既定値)。 (`eq`、`neinnot`、および `eq` の値) を`null`サポートします。`$filter`
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	この組織の連絡先の姓。 (`eq`、`nenotge`、`instartsWithle`および `eq` の値) を`null`サポートします。`$filter`

リレーションシップ

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