Bu sayfa, Cloud Translation API ile çevrilmiştir.

Veri kümesi alma

Veri kümesi oluşturup veri yükledikten sonra HTTP GET isteklerini kullanarak veri kümesine erişebilirsiniz. Bu sayfada, tüm veri kümelerinizi nasıl listeleyeceğiniz, belirli bir veri kümesi hakkında nasıl bilgi edineceğiniz ve bir veri kümesindeki verileri nasıl indireceğiniz açıklanmaktadır.

Veri kümesi sürümleri hakkında

Veri yükleme işlemi başarılı olduktan sonra veri kümesinin durumu STATE_COMPLETED olarak ayarlanır ve bu veri kümesi etkin sürüm haline gelir. Bu, veri kümesinin uygulamanızda kullanıma hazır olduğu anlamına gelir. Veri kümesinin state değerini belirlemek için tüm veri kümelerini listeleyebilir veya belirli bir veri kümesini alabilirsiniz.

Veri kümesinin yeni bir sürümünü oluşturmak için veri kümesine yeni veriler yükleyebilirsiniz:

Yeni veriler başarıyla yüklenirse yeni sürüm "etkin" sürüm haline gelir ve uygulamanız tarafından kullanılan sürüm olur.
Yükleme işleminde bir hata varsa önceki başarılı veri kümesi sürümü "etkin" sürüm olarak kalır ve uygulamanız tarafından kullanılan sürüm olur.

Veri kümesinin yeni bir sürümünü oluşturma hakkında daha fazla bilgi için Veri kümesine yeni veriler yükleme başlıklı makaleyi inceleyin.

Tüm veri kümelerini listeleme

Veri kümelerini listeleme uç noktasına bir HTTP GET isteği göndererek tüm veri kümelerini listeleyin:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets

Bu istek, sürümün etkin sürüm olup olmadığına bakılmaksızın tüm veri kümelerinin en son sürümüyle ilgili bilgileri döndürür. Yalnızca her veri kümesinin etkin sürümünü listelemek istiyorsanız isteğe tag=active sorgu parametresini ekleyin:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets?tag=active

Örneğin, bu çağrı tüm veri kümelerinin en son sürümüyle ilgili bilgileri döndürür:

curl -X GET \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H 'Authorization: Bearer $TOKEN' \
"https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets"

Bu çağrı, şu biçimde bir yanıt döndürür:

{
  "datasets": [
    {
      "name": "projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46",
      "displayName": "My Test Dataset",
      "versionId": "5fb34e-1405-4ecd-8f81-31f1c07",
      "usage": [
        "USAGE_DATA_DRIVEN_STYLING"
      ],
      "gcsSource": {
        "inputUri": "gs://mybucket/my.csv",
        "fileFormat": "FILE_FORMAT_CSV"
      },
      "createTime": "2023-03-24T14:47:37.308977Z",
      "updateTime": "2023-03-24T14:48:05.053114Z",
      "versionCreateTime": "2023-03-24T14:48:05.053114Z",
      "status": {
        "state": "STATE_COMPLETED"
      }
    },
    {
      "name": "projects/PROJECT_NUMBER_OR_ID/datasets/2c8ae479-96704-89c6435ca959",
      "displayName": "My Other Test Dataset",
      "versionId": "0d2e3-b9da-47cc-819f-7ac67562",
      "usage": [
        "USAGE_DATA_DRIVEN_STYLING"
      ],
      "localFileSource": {
        "fileFormat": "FILE_FORMAT_CSV"
      },
      "createTime": "2023-03-24T14:41:52.579755Z",
      "updateTime": "2023-03-24T14:42:56.784122Z",
      "versionCreateTime": "2023-03-24T14:42:56.784122Z",
      "status": {
        "state": "STATE_COMPLETED"
      }
    }
  ]
}

Veri kümesi hakkında bilgi edinme

Belirli bir veri kümesi hakkında bilgi edinmek için veri kümesini al uç noktasına HTTP GET isteği gönderin. Bu istek, veri kümesinin kimliğini de içerir:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID

Bu istek, sürümün etkin sürüm olup olmadığına bakılmaksızın veri kümesinin en son sürümüyle ilgili bilgileri döndürür. Veri kümesinin etkin sürümü hakkında bilgi edinmek istiyorsanız isteğe @active etiketini ekleyin:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID@active

Örneğin:

curl -X GET \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H 'Authorization: Bearer $TOKEN' \
"https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46@active"

Bu istek, şu biçimde bir yanıt döndürür:

{
  "name": "projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46",
  "displayName": "My Test Dataset",
  "versionId": "5fb34e-1405-4ecd-8f81-31f1c07",
  "usage": [
    "USAGE_DATA_DRIVEN_STYLING"
  ],
  "gcsSource": {
    "inputUri": "gs://mybucket/my.csv",
    "fileFormat": "FILE_FORMAT_CSV"
  },
  "createTime": "2023-03-24T14:47:37.308977Z",
  "updateTime": "2023-03-24T14:48:05.053114Z",
  "versionCreateTime": "2023-03-24T14:48:05.053114Z",
  "status": {
    "state": "STATE_COMPLETED"
  }
}

Veri kümesi indirme

Bir veri kümesinin en son sürümündeki verileri indirmek için HTTP GET isteğini veri kümesinin kimliğini de içeren veri kümesini indir uç noktasına gönderin:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID:download?alt=media