virtualEvent のCreate

[アーティクル]
05/02/2024

名前空間: microsoft.graph

重要

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

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

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

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

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

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

HTTP 要求

POST /solutions/virtualEvents/townhalls

要求ヘッダー

名前	説明
Authorization	ベアラー {token}。必須です。
Content-Type	application/json. 必須です。

要求本文

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

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

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

応答

成功した場合、このメソッドは 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": "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": "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:  '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": "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
}

Share via