EducationRubric の更新Update educationRubric

重要

Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。Use of these APIs in production applications is not supported.

EducationRubricオブジェクトのプロパティを更新します。Update the properties of an educationRubric object.

割り当てに関連付けられている割り当て (PATCH /education/me/assignments/{id}/rubric) を更新することは、割り当てが発行される前にのみ可能であり、更新されたもの/education/users/{id}/rubricsは、実際には、その下に存在する元のアカウントになります。Updating a rubric attached to an assignment (PATCH /education/me/assignments/{id}/rubric) is only possible before the assignment is published, and what is updated is actually the original rubric that exists under /education/users/{id}/rubrics. 割り当てが発行されると、その特定の割り当てに関連付けられている、保存期間の不変コピーが作成されます。After the assignment is published, an immutable copy of the rubric is made that is attached to that specific assignment. この場合、 GET/education/me/assignments/{id}/rubricを使用して取得できますが、更新することはできません。That rubric can be retrieved using GET /education/me/assignments/{id}/rubric, but it cannot be updated.

アクセス許可Permissions

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

アクセス許可の種類Permission type アクセス許可 (特権の小さいものから大きいものへ)Permissions (from least to most privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) EduAssignments の読み取り/書き込みの EduAssignmentsEduAssignments.ReadWriteBasic, EduAssignments.ReadWrite
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) サポートされていません。Not supported.
アプリケーションApplication サポートされていません。Not supported.

HTTP 要求HTTP request

PATCH /education/me/rubrics/{id}
PATCH /education/me/assignments/{id}/rubric

要求ヘッダーRequest headers

名前Name 説明Description
AuthorizationAuthorization ベアラー {トークン}Bearer {token}

要求本文Request body

要求本文で、更新する関連フィールドの値を指定します。In the request body, supply the values for relevant fields that should be updated. 要求本文に含まれない既存のプロパティは、以前の値のままになるか、他のプロパティ値の変化に基づいて再計算されます。Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. 最適なパフォーマンスを得るために、変更されていない既存の値を含めないでください。For best performance, don't include existing values that haven't changed.

プロパティProperty Type 説明Description
descriptiondescription Microsoft.outlookservices.itembodyitemBody このテンプレートの説明。The description of this rubric.
displayNamedisplayName StringString この名前を指定します。The name of this rubric.
変化grading educationAssignmentGradeTypeeducationAssignmentGradeType このテンプレートがポイントしているかどうか。Whether this rubric has points or not.
高度levels プリンシパルコレクションrubricLevel collection このテンプレートを構成するレベルのコレクション。The collection of levels making up this rubric.
満たしqualities の最高品質のコレクションrubricQuality collection このテンプレートを構成する品質のコレクション。The collection of qualities making up this rubric.

応答Response

成功した場合、このメソッド200 OKは応答コードと、応答本文で更新されたeducationRubricオブジェクトを返します。If successful, this method returns a 200 OK response code and an updated educationRubric object in the response body.

Examples

要求Request

要求の例を次に示します。The following is an example of the request.

PATCH https://graph.microsoft.com/beta/education/me/rubrics/{id}
Content-type: application/json

{
  "displayName": "Example Credit Rubric after display name patch"
}

応答Response

応答の例を次に示します。The following is an example of the response.

注: 読みやすくするために、ここに示す応答オブジェクトは短縮されている場合があります。実際の呼び出しからは、すべてのプロパティが返されます。Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json

{
    "displayName": "Example Credit Rubric after display name patch",
    "id": "c4459fcb-a761-4f70-ac5b-e9466cb77c2a",
    "description": {
        "content": "This is an example of a credit rubric (no points)",
        "contentType": "text"
    },
    "levels": [
        {
            "levelId": "dec665d4-cf1b-4481-ac61-1d5b6188f4f5",
            "displayName": "Good",
            "description": {
                "content": "",
                "contentType": "text"
            }
        },
        {
            "levelId": "3f2e4b0f-508e-4005-984b-17e061bc5377",
            "displayName": "Poor",
            "description": {
                "content": "",
                "contentType": "text"
            }
        }
    ],
    "qualities": [
        {
            "qualityId": "dc79dcbf-b536-4797-9c5b-902f28129fd0",
            "description": {
                "content": "Argument",
                "contentType": "text"
            },
            "criteria": [
                {
                    "id": "8937fa15-4a7c-4f27-bd01-ca3471d2d1d5",
                    "description": {
                        "content": "The essay's argument is persuasive.",
                        "contentType": "text"
                    }
                },
                {
                    "id": "4dfb5263-1d3f-4f0a-93ef-d24d800d0f69",
                    "description": {
                        "content": "The essay's argument does not make sense.",
                        "contentType": "text"
                    }
                }
            ]
        },
        {
            "qualityId": "7e087062-ac25-4629-8386-a946350936db",
            "description": {
                "content": "Spelling and Grammar",
                "contentType": "text"
            },
            "criteria": [
                {
                    "id": "12276eb2-122c-4ad2-ba92-335ea798c88e",
                    "description": {
                        "content": "The essay uses proper spelling and grammar with few or no errors.",
                        "contentType": "text"
                    }
                },
                {
                    "id": "3db7e6b2-2b1b-4f8e-9fca-bea701159145",
                    "description": {
                        "content": "The essay has numerous errors in spelling and/or grammar.",
                        "contentType": "text"
                    }
                }
            ]
        }
    ]
}