TimeCard の作成

名前空間: microsoft.graph

重要

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

スケジュールに timeCard インスタンスを作成 します。

アクセス許可

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

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)	Schedule.ReadWrite.All
委任 (個人用 Microsoft アカウント)	サポートされていません。
アプリケーション	Schedule.ReadWrite.All*

*大事な： アプリケーションのアクセス許可を使用する場合は、要求に MS-APP-ACTS-AS ヘッダーを含める必要があります。

HTTP 要求

POST /teams/{teamId}/schedule/timecards

要求ヘッダー

ヘッダー	値
Authorization	ベアラー {token}。必須。
Content-type	application/json. Required.
MS-APP-ACTS-AS	アプリが機能しているユーザーの代わりに使用する ID。 アプリケーションのアクセス許可スコープを使用する場合は必須です。

要求本文

このメソッドの 要求本文 に新しい timeCard オブジェクトを指定します。

応答

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

例

要求

要求の例を次に示します。

HTTP

POST https://graph.microsoft.com/beta/teams/871dbd5c-3a6a-4392-bfe1-042452793a50/schedule/timecards
Content-type: application/json

{
  "onBehalfOfUserId":"a3601044-a1b5-438e-b742-f78d01d68a67",
  "clockInEvent":{
     "dateTime":"2019-03-18T00:00:00.000Z",
     "atApprovedLocation":true,
     "notes": {
        "content": "Started late due to traffic in CA 237",
        "contentType": "text"
     },
  },
  "notes":{
        "content": "8 To 5 Inventory management",
        "contentType": "text"
   },
  "breaks":[
     {
       "breakId": "string",
        "notes":{
             "content": "Lunch break",
             "contentType": "text"
        },
        "start":{
           "dateTime":"2019-03-18T02:00:00.000Z",
           "atApprovedLocation":true,
           "notes": {
                "content": "Reduced break to make up for lost time",
                "contentType": "text"
             },
        }
     }
  ]
}

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

const timeCard = {
  onBehalfOfUserId: 'a3601044-a1b5-438e-b742-f78d01d68a67',
  clockInEvent: {
     dateTime: '2019-03-18T00:00:00.000Z',
     atApprovedLocation: true,
     notes: {
        content: 'Started late due to traffic in CA 237',
        contentType: 'text'
     },
  },
  notes: {
        content: '8 To 5 Inventory management',
        contentType: 'text'
   },
  breaks: [
     {
       breakId: 'string',
        notes: {
             content: 'Lunch break',
             contentType: 'text'
        },
        start: {
           dateTime: '2019-03-18T02:00:00.000Z',
           atApprovedLocation: true,
           notes: {
                content: 'Reduced break to make up for lost time',
                contentType: 'text'
             },
        }
     }
  ]
};

await client.api('/teams/871dbd5c-3a6a-4392-bfe1-042452793a50/schedule/timecards')
    .version('beta')
    .post(timeCard);

重要

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

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

Objective-C

MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/teams/871dbd5c-3a6a-4392-bfe1-042452793a50/schedule/timecards"]]];
[urlRequest setHTTPMethod:@"POST"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

MSGraphTimeCard *timeCard = [[MSGraphTimeCard alloc] init];
[timeCard setOnBehalfOfUserId:@"a3601044-a1b5-438e-b742-f78d01d68a67"];
MSGraphTimeCardEvent *clockInEvent = [[MSGraphTimeCardEvent alloc] init];
[clockInEvent setDateTime: "2019-03-18T00:00:00Z"];
[clockInEvent setAtApprovedLocation: true];
MSGraphItemBody *notes = [[MSGraphItemBody alloc] init];
[notes setContent:@"Started late due to traffic in CA 237"];
[notes setContentType: [MSGraphBodyType text]];
[clockInEvent setNotes:notes];
[timeCard setClockInEvent:clockInEvent];
MSGraphItemBody *notes = [[MSGraphItemBody alloc] init];
[notes setContent:@"8 To 5 Inventory management"];
[notes setContentType: [MSGraphBodyType text]];
[timeCard setNotes:notes];
NSMutableArray *breaksList = [[NSMutableArray alloc] init];
MSGraphTimeCardBreak *breaks = [[MSGraphTimeCardBreak alloc] init];
[breaks setBreakId:@"string"];
MSGraphItemBody *notes = [[MSGraphItemBody alloc] init];
[notes setContent:@"Lunch break"];
[notes setContentType: [MSGraphBodyType text]];
[breaks setNotes:notes];
MSGraphTimeCardEvent *start = [[MSGraphTimeCardEvent alloc] init];
[start setDateTime: "2019-03-18T02:00:00Z"];
[start setAtApprovedLocation: true];
MSGraphItemBody *notes = [[MSGraphItemBody alloc] init];
[notes setContent:@"Reduced break to make up for lost time"];
[notes setContentType: [MSGraphBodyType text]];
[start setNotes:notes];
[breaks setStart:start];
[breaksList addObject: breaks];
[timeCard setBreaks:breaksList];

NSError *error;
NSData *timeCardData = [timeCard getSerializedDataWithError:&error];
[urlRequest setHTTPBody:timeCardData];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];

重要

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

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

Go

//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestBody := msgraphsdk.NewTimeCard()
clockInEvent := msgraphsdk.NewTimeCardEvent()
requestBody.SetClockInEvent(clockInEvent)
dateTime, err := time.Parse(time.RFC3339, "2019-03-18T00:00:00.000Z")
clockInEvent.SetDateTime(&dateTime)
atApprovedLocation := true
clockInEvent.SetAtApprovedLocation(&atApprovedLocation)
notes := msgraphsdk.NewItemBody()
clockInEvent.SetNotes(notes)
content := "Started late due to traffic in CA 237"
notes.SetContent(&content)
contentType := "text"
notes.SetContentType(&contentType)
notes := msgraphsdk.NewItemBody()
requestBody.SetNotes(notes)
content := "8 To 5 Inventory management"
notes.SetContent(&content)
contentType := "text"
notes.SetContentType(&contentType)
requestBody.SetBreaks( []TimeCardBreak {
    msgraphsdk.NewTimeCardBreak(),
breakId := "string"
    SetBreakId(&breakId)
notes := msgraphsdk.NewItemBody()
    SetNotes(notes)
content := "Lunch break"
    notes.SetContent(&content)
contentType := "text"
    notes.SetContentType(&contentType)
start := msgraphsdk.NewTimeCardEvent()
    SetStart(start)
dateTime, err := time.Parse(time.RFC3339, "2019-03-18T02:00:00.000Z")
    start.SetDateTime(&dateTime)
atApprovedLocation := true
    start.SetAtApprovedLocation(&atApprovedLocation)
notes := msgraphsdk.NewItemBody()
    start.SetNotes(notes)
content := "Reduced break to make up for lost time"
    notes.SetContent(&content)
contentType := "text"
    notes.SetContentType(&contentType)
}
requestBody.SetAdditionalData(map[string]interface{}{
    "onBehalfOfUserId": "a3601044-a1b5-438e-b742-f78d01d68a67",
}
teamId := "team-id"
result, err := graphClient.TeamsById(&teamId).Schedule().TimeCards().Post(requestBody)

重要

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

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

PowerShell

Import-Module Microsoft.Graph.Teams

$params = @{
    OnBehalfOfUserId = "a3601044-a1b5-438e-b742-f78d01d68a67"
    ClockInEvent = @{
        DateTime = [System.DateTime]::Parse("2019-03-18T00:00:00.000Z")
        AtApprovedLocation = $true
        Notes = @{
            Content = "Started late due to traffic in CA 237"
            ContentType = "text"
        }
    }
    Notes = @{
        Content = "8 To 5 Inventory management"
        ContentType = "text"
    }
    Breaks = @(
        @{
            BreakId = "string"
            Notes = @{
                Content = "Lunch break"
                ContentType = "text"
            }
            Start = @{
                DateTime = [System.DateTime]::Parse("2019-03-18T02:00:00.000Z")
                AtApprovedLocation = $true
                Notes = @{
                    Content = "Reduced break to make up for lost time"
                    ContentType = "text"
                }
            }
        }
    )
}

New-MgTeamScheduleTimeCard -TeamId $teamId -BodyParameter $params

重要

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

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

応答

応答の例を次に示します。

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

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

{
   "id":"3895809b-a618-4c0d-86a0-d42b25b7d74f",
   "userId":"a3601044-a1b5-438e-b742-f78d01d68a67",
   "createdDateTime":"2019-03-18T00:00:00.000Z",
   "createdBy":{
      "user":{
         "id":"a3601044-a1b5-438e-b742-f78d01d68a67",
         "displayName":"Dwight Schrute"
      }
   },
   "lastModifiedDateTime":"2019-03-18T00:00:00.000Z",
   "lastModifiedBy":{
      "user":{
         "id":"a3601044-a1b5-438e-b742-f78d01d68a67",
         "displayName":"Dwight Schrute"
      }
   },
   "state":"onBreak",
   "confirmationStatus":"notConfirmed",
   "originalEntry":{
      "clockInEvent":{
         "dateTime":"2019-03-18T00:00:00.000Z",
         "atApprovedLocation":true,
         "notes": {
            "content": "Started late due to traffic in CA 237",
           "contentType": "text"
         },
      },
      "clockOutEvent":null,
      "breaks":[
         {
            "breakId":"string",
            "notes":{
                "content": "Lunch break",
                "contentType": "text"
             },
            "start":{
               "dateTime":"2019-03-18T02:00:00.000Z",
               "atApprovedLocation":true,
               "notes": {
                  "content": "Reduced break to make up for lost time",
                  "contentType": "text"
               },
            },
            "end":null
         }
      ]
   },
   "clockInEvent":{
      "dateTime":"2019-03-18T00:00:00.000Z",
      "atApprovedLocation":true,
      "notes": {
        "content": "Started late due to traffic in CA 237",
        "contentType": "text"
     },
   },
   "clockOutEvent":null,
   "notes":{
        "content": "8 To 5 Inventory management",
        "contentType": "text"
   },
   "breaks":[
      {
         "breakId":"string",
         "notes":{
             "content": "Lunch break",
             "contentType": "text"
         },
         "start":{
            "dateTime":"2019-03-18T02:00:00.000Z",
            "atApprovedLocation":true,
            "notes": {
                "content": "Reduced break to make up for lost time",
                "contentType": "text"
             },
         },
         "end":null
      }
   ]
}