Web サイトを一覧表示するList websites

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

重要

/betaMicrosoft Graph のバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。Use of these APIs in production applications is not supported. API が v2.0 で利用できるかどうかを確認するには、 バージョン セレクターを使用します。To determine whether an API is available in v1.0, use the Version selector.

ユーザーのプロファイルから個人 web サイトオブジェクトのリストを取得します。Retrieve a list of personWebsite 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/websites
GET /users/{id | userPrincipalName}/profile/websites

オプションのクエリ パラメーター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 コードと、応答本文で 個人の web サイト オブジェクトのコレクションを返します。If successful, this method returns a 200 OK response code and a collection of personWebsite objects in the response body.

Examples

要求Request

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

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

応答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

{
  "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"
        }
      },
      "categories": [
        "football"
      ],
      "description": "Lyn Damer play in the Women's 1st Division (Toppserien) in Norway",
      "displayName": "Lyn Damer",
      "webUrl": "www.lyndamer.no"
    }
  ]
}