従業員の更新
名前空間: microsoft.graph
重要
Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。
Dynamics 365 Business Central の従業員オブジェクトのプロパティを更新します。
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
| アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
|---|---|
| 委任 (職場または学校のアカウント) | Financials.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 |
| アプリケーション | Financials.ReadWrite.All |
HTTP 要求
PATCH /financials/companies/{id}/employees/{id}
オプションのクエリ パラメーター
このメソッドは、応答をカスタマイズするための OData クエリ パラメーターをサポートします。
要求ヘッダー
| ヘッダー | 値 |
|---|---|
| Authorization | ベアラー {トークン}。必須。 |
| Content-Type | application/json. |
| If-Match | 必須です。 この要求ヘッダーが含まれていて、指定された eTag が従業員の現在のタグと一致しない場合、従業員は更新されません。 |
要求本文
要求本文で、更新する関連フィールドの値を指定します。要求本文に含まれない既存のプロパティは、以前の値のままになるか、他のプロパティ値の変化に基づいて再計算されます。最適なパフォーマンスを得るためには、変更されていない既存の値を含めないでください。
応答
成功した場合、このメソッドは応答コードと更新された 200 OK employees オブジェクトを応答本文で返します。
例
要求
以下は、要求の例です。
PATCH https://graph.microsoft.com/beta/financials/companies/{id}/employees/{id}
Content-type: application/json
{
"givenName": "Anthony",
"phoneNumber": "0678-8712-3455"
}
応答
以下は、応答の例です。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "id-value",
"number": "AH",
"displayName": "Anthony Hill",
"givenName": "Anthony",
"middleName": "",
"surname": "Hill",
"jobTitle": "Secretary",
"address": {
"street": "677 Fifth Avenue",
"city": "New York",
"state": "",
"countryLetterCode": "",
"postalCode": "10022"
},
"phoneNumber": "0678-8712-3455",
"mobilePhone": "4564-4564-7831",
"email": "",
"personalEmail": "ah@cronus-demosite.com",
"employmentDate": "2001-06-01",
"terminationDate": "0001-01-01",
"status": "Active",
"birthDate": "1973-12-12",
"picture@odata.mediaReadLink": "https://api.financials.dynamics.com/v1.0/api/beta/companies/{id}/employees/{id}/picture",
"lastModifiedDateTime": "2017-03-16T14:57:19.497Z"
}
フィードバック
フィードバックの送信と表示