orgContact リソースの種類
名前空間: 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 、ne not ge 、in startsWith le および eq の値) をnull サポートします。$filter |
department | String | 連絡先が機能する部署の名前。 (eq 、ne not ge 、in startsWith le および eq の値) をnull サポートします。$filter |
displayName | String | この組織の連絡先の表示名。 $filter (eq 、ne ge not 、le 、in startsWith 、および eq のnull 値)$search 、および をサポートします。$orderby |
givenName | String | この組織の連絡先の名。 (eq 、ne not ge 、in startsWith le および eq の値) をnull サポートします。$filter |
id | String | この組織の連絡先の一意の識別子。 $filter (eq 、ne 、not 、in ) をサポートします。 |
jobTitle | String | この組織の連絡先の役職。 (eq 、ne not ge 、in startsWith le および eq の値) をnull サポートします。$filter |
String | 連絡先の SMTP アドレス ("" などjeff@contoso.com)。 (eq 、ne not ge 、in startsWith le および eq の値) をnull サポートします。$filter |
|
mailNickname | String | Emailこの組織の連絡先のエイリアス (電子メール アドレスの一部が @ 記号より前に保留されています)。 (eq 、ne not ge 、in startsWith le および 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 、ne in not 、および 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 、ne not ge 、le 、in startsWith 、および 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"
}
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示