> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取数据集视图

> 列出您的数据集视图及其ID、名称和底层数据集，以便您可以为每个订阅配置或更新交付设置。

数据集视图是一个已保存的、经过筛选的 Bright Data 市场数据集订阅，可按重复计划将新记录传送到您的目标。每个视图都有一个唯一的 `id`（例如 `v_id1`），您可以将其传递到视图投放设置端点。

使用此处返回的 `id` 配合以下功能：

* [获取视图投放设置](/api-reference/marketplace-dataset-api/get-view-delivery-settings)以检查当前配置。
* [更新视图投放设置](/api-reference/marketplace-dataset-api/update-view-delivery-settings)以更改配置。
* [批量更新视图投放设置](/api-reference/marketplace-dataset-api/bulk-update-view-delivery-settings)以一次性对多个视图应用一项配置。


## OpenAPI

````yaml api-reference/dca-api GET /datasets/views
openapi: 3.1.0
info:
  title: Brightdata API
  description: API for interaction with datasets marketplace
  version: 1.0.0
servers:
  - url: https://api.brightdata.com
security:
  - bearerAuth: []
paths:
  /datasets/views:
    get:
      description: >-
        Retrieves the customer's dataset views. A dataset view represents a
        saved filtered subscription to a dataset that can be delivered on a
        schedule. Use the returned `id` with the view delivery settings
        endpoints.
      responses:
        '200':
          description: List of dataset views
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      description: Unique identifier for the dataset view
                    name:
                      type: string
                      description: Customer-assigned name for the view
                    dataset_id:
                      type: string
                      description: ID of the underlying dataset
                    dataset_name:
                      type: string
                      description: Name of the underlying dataset
                    domain:
                      type: string
                      description: Primary domain of the dataset
              example:
                - id: v_id1
                  name: test1
                  dataset_id: gd_id1
                  dataset_name: Dataset One
                  domain: datasetonename.com
                - id: v_id2
                  name: test2
                  dataset_id: gd_id2
                  dataset_name: Dataset Two
                  domain: datasettwoname.com
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Unauthorized
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Use your Bright Data API Key as a Bearer token in the Authorization
        header.


        **How to authenticate:**

        1. Obtain your API Key from the Bright Data account settings at
        https://brightdata.com/cp/setting/users

        2. Include the API Key in the Authorization header of your requests

        3. Format: `Authorization: Bearer YOUR_API_KEY`


        **Example:**

        ```

        Authorization: Bearer YOUR_API_KEY

        ```


        Learn how to get your Bright Data API key:
        https://docs.brightdata.com/api-reference/authentication
      bearerFormat: API Key

````