externalMeetingRegistration を作成する (非推奨)

[アーティクル]
07/16/2024

名前空間: microsoft.graph

重要

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

注意

外部会議登録 API は非推奨となり 、2024 年 12 月 31 日にデータの返しを停止します。新しいウェビナー API を使用してください。詳細については、「 Microsoft Graph 会議登録ベータ API の廃止」を参照してください。

外部登録システムを使用して onlineMeeting の登録を有効にします。オンライン会議で有効にできる登録は 1 つだけです。

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類	最小特権アクセス許可	より高い特権のアクセス許可
委任 (職場または学校のアカウント)	OnlineMeetings.ReadWrite	注意事項なし。
委任 (個人用 Microsoft アカウント)	サポートされていません。	サポートされていません。
アプリケーション	サポートされていません。	サポートされていません。

この API のアプリケーションアクセス許可を使用するには、テナント管理者はアプリケーションアクセスポリシーを作成し、そのユーザーに代わってオンライン会議やオンライン会議成果物を取得するようにポリシーで構成されたアプリを承認するようにユーザーに付与する必要があります (要求パスにユーザー ID が指定されています)。

HTTP 要求

委任された (/me) とアプリ (/users/{userId}/) アクセス許可を持つ外部会議登録を作成するには:

POST /me/onlineMeetings/{meetingId}/registration
POST /users/{userId}/onlineMeetings/{meetingId}/registration

ヒント

userId は、会議の開催者の objectId です 。
meetingIdは、onlineMeeting オブジェクトの ID です。

要求ヘッダー

名前	説明
Authorization	ベアラー {token}。必須です。認証と認可についての詳細をご覧ください。

要求本文

要求本文で、 externalMeetingRegistration オブジェクトの JSON 表現を指定します。

重要

登録の種類を指定するには 、@odata.type プロパティを指定する必要があります。詳細については、次の例を参照してください。

応答

成功した場合、このメソッドは 201 Created 応答コードと、応答本文の externalMeetingRegistration オブジェクトを返します。

例

POST https://graph.microsoft.com/beta/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZ/registration
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.externalMeetingRegistration",
  "allowedRegistrant": "everyone"
}


const options = {
	authProvider,
};

const client = Client.init(options);

const meetingRegistration = {
  '@odata.type': '#microsoft.graph.externalMeetingRegistration',
  allowedRegistrant: 'everyone'
};

await client.api('/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZ/registration')
	.version('beta')
	.post(meetingRegistration);

重要

Microsoft Graph SDK では、既定で v1.0 バージョンの API が使用され、ベータ版で使用可能なすべての型、プロパティ、API がサポートされているわけではありません。 SDK を使用してベータ API にアクセスする方法の詳細については、「ベータ API で Microsoft Graph SDK を使用する」を参照してください。

プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

応答

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('16664f75-11dc-4870-bec6-38c1aaa81431')/onlineMeetings('MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZ')/registration/$entity",
  "@odata.type": "#microsoft.graph.externalMeetingRegistration",
  "id": "f23714a3-a2f4-4b1d-96d2-bfe9097e7163",
  "allowedRegistrant": "everyone"
}

次の方法で共有