virtualEventTownhall を作成する

[アーティクル]
10/18/2024

名前空間: microsoft.graph

重要

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

下書きモードで新しい virtualEventTownhall オブジェクトを作成します。

この API は、次の国内クラウド展開で使用できます。

グローバルサービス	米国政府機関 L4	米国政府機関 L5 (DOD)	21Vianet が運営する中国
✅	❌	❌	❌

アクセス許可

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

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

HTTP 要求

POST /solutions/virtualEvents/townhalls

要求ヘッダー

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

要求本文

要求本文で、サポートされている派生型 virtualEventTownhall オブジェクトの JSON 表現を指定します。

virtualEventTownhall を作成するときに、次のプロパティを指定できます。

プロパティ	型	説明
聴衆	meetingAudience	タウンホールが表示される対象ユーザー。
coOrganizers	communicationsUserIdentity コレクション	タウンホールの共同組織の ID 情報。
説明	itemBody	市庁舎の説明。
displayName	String	タウンホールの表示名。
endDateTime	dateTimeTimeZone	タウンホールが終了する日時。
invitedAttendees	IDENTITY コレクション	タウンホールに招待された出席者の ID。サポートされている ID は、 communicationsGuestIdentity と communicationsUserIdentity です。
isInviteOnly	ブール型	タウンホールが組織内の招待されたユーザーとグループにのみ開かれているかどうかを示します。 isInviteOnly プロパティは、対象ユーザープロパティの値が `organization` に設定されている場合にのみ`true`できます。
settings	virtualEventSettings	タウンホールの設定。
startDateTime	dateTimeTimeZone	タウンホールが開始される日時。

応答

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

例

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/beta/solutions/virtualEvents/townhalls
Content-Type: application/json

{     
    "displayName": "The Impact of Tech on Our Lives",
    "description": {
      "contentType": "text",
      "content": "Discusses how technology has changed the way we communicate."
    },
    "startDateTime": {
      "dateTime": "2023-03-30T10:00:00", 
      "timeZone": "Pacific Standard Time" 
    },
    "endDateTime": {
      "dateTime": "2023-03-30T17:00:00", 
      "timeZone": "Pacific Standard Time" 
    },
    "audience": "organization",
    "coOrganizers": [
      { 
        "id": "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b", 
        "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" 
      }
    ],
    "settings": {
      "isAttendeeEmailNotificationEnabled": false
    }
}



mgc-beta solutions virtual-events townhalls create --body '{\
    "displayName": "The Impact of Tech on Our Lives",\
    "description": {\
      "contentType": "text",\
      "content": "Discusses how technology has changed the way we communicate."\
    },\
    "startDateTime": {\
      "dateTime": "2023-03-30T10:00:00", \
      "timeZone": "Pacific Standard Time" \
    },\
    "endDateTime": {\
      "dateTime": "2023-03-30T17:00:00", \
      "timeZone": "Pacific Standard Time" \
    },\
    "audience": "organization",\
    "coOrganizers": [\
      { \
        "id": "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b", \
        "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" \
      }\
    ],\
    "settings": {\
      "isAttendeeEmailNotificationEnabled": false\
    }\
}\
'

重要

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

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


const options = {
	authProvider,
};

const client = Client.init(options);

const virtualEventTownhall = {
    displayName:  'The Impact of Tech on Our Lives',
    description:  {
      contentType: 'text',
      content: 'Discusses how technology has changed the way we communicate.'
    },
    startDateTime:  {
      dateTime:  '2023-03-30T10:00:00', 
      timeZone:  'Pacific Standard Time' 
    },
    endDateTime:  {
      dateTime:  '2023-03-30T17:00:00', 
      timeZone:  'Pacific Standard Time' 
    },
    audience:  'organization',
    coOrganizers:  [
      { 
        id:  '7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b', 
        tenantId:  '77229959-e479-4a73-b6e0-ddac27be315c' 
      }
    ],
    settings: {
      isAttendeeEmailNotificationEnabled: false
    }
};

await client.api('/solutions/virtualEvents/townhalls')
	.version('beta')
	.post(virtualEventTownhall);

重要

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

応答

次の例は応答を示しています。

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

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

{ 
    "id": "bce9a3ca-a310-48fa-baf3-1cedcd04bb3f@4aa05bcc-1cac-4a83-a9ae-0db84b88f4ba",
    "status": "draft",
    "displayName": "The Impact of Tech on Our Lives",
    "description": {
      "contentType": "text",
      "content": "Discusses how technology has changed the way we communicate."
    },
    "startDateTime": {
      "dateTime": "2023-03-30T10:00:00", 
      "timeZone": "Pacific Standard Time" 
    },
    "endDateTime": {
      "dateTime": "2023-03-30T17:00:00", 
      "timeZone": "Pacific Standard Time" 
    },
    "audience": "organization",
    "createdBy": {
      "application": null,
      "device": null,
      "user": {
        "id": "b7ef013a-c73c-4ec7-8ccb-e56290f45f68",
        "displayName": "Diane Demoss",
        "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c"
      }
    },
    "coOrganizers": [
      { 
        "id": "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b", 
        "displayName": "Kenneth Brown", 
        "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" 
      }
    ],
    "invitedAttendees": [],
    "settings": {
      "isAttendeeEmailNotificationEnabled": false
    },
    "isInviteOnly": false,
    "externalEventInformation": []
}

次の方法で共有

virtualEventTownhall を作成する

アクセス許可

HTTP 要求

要求ヘッダー

要求本文

応答

例

要求

応答

フィードバック

その他のリソース