virtualEventTownhall を作成する

[アーティクル]
05/29/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`使用できます。
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" 
      }
    ]
}



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" \
      }\
    ]\
}\
'

重要

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' 
      }
    ]
};

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": [],
    "isInviteOnly": false
}

次の方法で共有