賞のリストList awards

名前空間: microsoft.graphNamespace: microsoft.graph

ユーザーのプロファイルから個人特典オブジェクトのリストを取得します。Retrieve a list of personAward objects from a user's profile.

アクセス許可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) User. 読み取り、ユーザーの読み取り/書き込み、ユーザー。すべてのユーザーの読み取り、書き込み、および読み取り。User.Read, User.ReadWrite, User.ReadBasic.All, User.Read.All, User.ReadWrite.All
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) User. 読み取り、ユーザーの読み取り/書き込み、ユーザー。すべてのユーザーの読み取り、書き込み、および読み取り。User.Read, User.ReadWrite, User.ReadBasic.All, User.Read.All, User.ReadWrite.All
アプリケーションApplication すべてのユーザーを取得します。すべてのユーザーに対して。User.ReadBasic.All, User.Read.All, User.ReadWrite.All

HTTP 要求HTTP request

GET /me/profile/awards
GET /users/{id | userPrincipalName}/profile/awards

オプションのクエリ パラメーターOptional query parameters

このメソッドは、応答をカスタマイズするために、次の OData クエリパラメーターをサポートします。This method supports the following OData query parameters to help customize the response. 一般的な情報については、「OData クエリ パラメーター」を参照してください。For general information, see OData query parameters.

名前Name Value 説明Description
$filter$filter stringstring 指定した条件を含むオブジェクトのみに応答を制限します。Limits the response to only those objects which contain the specified criteria.
$orderby$orderby stringstring 既定では、応答内のオブジェクトは、クエリ内の指定された Datetime 値で並べ替えられます。By default the objects in the response are sorted by their createdDateTime value in a query. 応答の順序は $orderby パラメーターを使用して変更できます。You can change the order of the of the response using the $orderby parameter.
$select$select stringstring 応答に含めるプロパティを示すコンマ区切りのリスト。最適なパフォーマンスを得るには、必要なプロパティのサブセットのみを選択します。Comma-separated list of properties to include in the response. For optimal performance, only select the subset of properties needed.
$skip$skip intint 最初の n 件の結果をスキップして、ページングに役立てることができます。Skip the first n results, useful for paging.
$top$top intint 返される結果の数。Number of results to be returned.

要求ヘッダーRequest headers

名前Name 説明Description
AuthorizationAuthorization ベアラー {トークン}。必須。Bearer {token}. Required.

要求本文Request body

このメソッドには、要求本文を指定しません。Do not supply a request body for this method.

応答Response

成功した場合、このメソッドは応答 200 OK コードと、応答本文で 個人特典 オブジェクトのコレクションを返します。If successful, this method returns a 200 OK response code and a collection of personAward objects in the response body.

Examples

GET https://graph.microsoft.com/beta/me/profile/awards

応答Response

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。Note: The response object shown here might be shortened for readability.

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

{
  "value": [
    {
      "id": "0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f",
      "allowedAudiences": "organization",
      "inference": null,
      "createdDateTime": "2020-07-06T06:34:12.2294868Z",
      "createdBy": {
        "application": null,
        "device": null,
        "user": {
          "displayName": "Innocenty Popov",
          "id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
        }
      },
      "lastModifiedDateTime": "2020-07-06T06:34:12.2294868Z",
      "lastModifiedBy": {
        "application": null,
        "device": null,
        "user": {
          "displayName": "Innocenty Popov",
          "id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
        }
      },
      "source": null,
      "description": "Lifetime Achievement award from the International Association of Branding Managers",
      "displayName": "Lifetime Achievement Award For Excellence in Branding",
      "issuedDate": "Date",
      "issuingAuthority": "International Association of Branding Management",
      "thumbnailUrl": "https://iabm.io/sdhdfhsdhshsd.jpg",
      "webUrl": "https://www.iabm.io"
    }
  ]
}