Memfilter saat mencantumkan

Anda dapat menggunakan pemfilteran untuk menampilkan hasil yang lebih spesifik saat mencantumkan resource, evaluasi, atau operasi.

Poin penting: Secara umum, Anda memfilter dengan menambahkan sintaksis berikut ke URL permintaan:

• ?filter="[filter_name=]filter-value" - menampilkan semua objek JSON yang cocok dengan filter-value.
• ?filter="" - filter yang tidak ditetapkan. Tidak ada kecocokan yang ditampilkan.
• ?filter="*" - filter yang cocok dengan semua nilai yang mungkin.

Operasi

Anda dapat memfilter operasi yang tercantum menggunakan parameter berikut:

Filter

• operation_id - menampilkan semua operasi dengan ID yang sama dengan nilai yang diberikan. Anda juga dapat menentukan operasi yang tidak sama dengan (!=) dengan nilai tertentu.
• done - menampilkan semua operasi dengan status "done": true. Anda juga dapat menentukan operasi yang masih berjalan (bukan "done").

  Kueri:

  • ?filter="done=true"
  • ?filter="done!=true"
• worksOn - menampilkan semua operasi yang berfungsi pada resource (set data atau model). Anda juga dapat menentukan operasi yang tidak sama dengan (!=) dengan nilai tertentu.

  Kueri:

  • set data - ?filter="worksOn=projects/project-id/locations/us-central1/datasets/dataset-id"
  • model - ?filter="worksOn=projects/project-id/locations/us-central1/models/model-id"

Parameter kueri tambahan

• pageSize - Membatasi hasil yang ditampilkan ke sejumlah baris tertentu. Jika tidak ditentukan, server akan memilih ukuran default.
• pageToken - Token untuk mengambil halaman hasil berikutnya. Kueri awal dengan kumpulan pageSize dan hasil yang lebih besar dari yang dapat dimuat di ukuran halaman juga akan menampilkan nextPageToken. Token ini kemudian dapat diteruskan ke pageToken untuk mendapatkan hasil berikutnya.

Contoh kode command line berikut menunjukkan cara memfilter operasi yang tercantum berdasarkan operasi yang telah selesai (berstatus "done": true).

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• project-id: project Google Cloud Platform Anda ID.

Metode HTTP dan URL:

GET https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/operations?filter="done=true"

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: project-id" \
     "https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/operations?filter="done=true""

PowerShell

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "project-id" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/operations?filter="done=true"" | Select-Object -Expand Content

Jika permintaan berhasil, server akan menampilkan kode status HTTP 200 OK dan respons dalam format JSON.

Respons berikut berasal dari project dengan beberapa operasi AutoML, yang difilter menurut operasi yang telah selesai (?filter="done=true").

Respons

"
project-idproject-idproject-idVCN1765936620487311360v1v1v1storage-bucket
          },
          {
            "code": 3,
            "message": "Error: Contoh label tunggal 6192816919589105442 dapat memiliki maksimal satu anotasi positif yang disetujui."
          },
          {
            "code": 3,
            "message": "Error: gs://storage-bucket/csv/all_data.csv baris 2267: Label sudah menjadi kebenaran dasar."
          project-idproject-idproject-idproject-idproject-idproject-idTBL1400159888251813888v1v1v1v1v1v1 Beberapa dokumen (baris 2552 dan baris 3528) berbagi konten yang sama."
          },
          {
            "code": 3,
            "message": "Error: gs://automl-docs-filtering-vcm/happiness.csv baris 3527: Label sudah menjadi kebenaran dasar."
          }
 ],
 "createTime": "2019-12-11T22:22:40.789066Z",
 "updateTime": "2019-12-11T22:36:40.388359Z",
 "importDataDetails": {}
 },
      "done": true,

Parameter kueri tambahan

Untuk membuat kueri dengan parameter lain (pageSize, pageToken), tambahkan parameter tersebut ke URL:

https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/model/model-id/modelEvaluations?pageSize=INT

Anda juga dapat menyambungkan parameter dengan ampersand (&):

https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/model/model-id/modelEvaluations?filter="done=true&pageSize=INT&pageToken=next-page-token"

Set data

Anda dapat memfilter set data yang tercantum menggunakan parameter berikut:

Filter

• dataset_metadata - menampilkan semua set data dengan jenis metadata target.

  Nilai yang tersedia

  • imageClassificationDatasetMetadata:* (AutoML Vision - Klasifikasi Gambar)
  • imageObjectDetectionDatasetMetadata:* (AutoML Vision - Deteksi Objek)
  • textClassificationDatasetMetadata:* (AutoML Natural Language - Klasifikasi)
  • textExtractionDatasetMetadata:* (AutoML Natural Language - Ekstraksi Entity)
  • textSentimentDatasetMetadata:* (AutoML Natural Language - Analisis Sentimen)
  • translationDatasetMetadata:* (Terjemahan AutoML)

Parameter kueri tambahan

• pageSize - Membatasi hasil yang ditampilkan ke sejumlah baris tertentu. Jika tidak ditentukan, server akan memilih ukuran default.
• pageToken - Token untuk mengambil halaman hasil berikutnya. Kueri awal dengan kumpulan pageSize dan hasil yang lebih besar dari yang dapat dimuat di ukuran halaman juga akan menampilkan nextPageToken. Token ini kemudian dapat diteruskan ke pageToken untuk mendapatkan hasil berikutnya.

Contoh kode command line berikut menunjukkan cara memfilter set data yang tercantum dengan menentukan dataset_metadata.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• project-id: project Google Cloud Platform Anda ID.
• dataset-metadata-value: jenis dataset_metadata yang Anda filter. Nilai ini bergantung pada jenis masalah AutoML.

Metode HTTP dan URL:

GET https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/datasets?filter="dataset-metadata-value"

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: project-id" \
     "https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/datasets?filter="dataset-metadata-value""

PowerShell

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "project-id" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/datasets?filter="dataset-metadata-value"" | Select-Object -Expand Content

Jika permintaan berhasil, server akan menampilkan kode status HTTP 200 OK dan respons dalam format JSON.

Respons berikut berasal dari project dengan beberapa jenis set data AutoML, difilter untuk set data AutoML Translation (?filter="translationDatasetMetadata:*").

Respons:

Respons

 {
 "DatasetzCodes1: {i>“<a href="1/1
“<b}{bi>="<a}{bi>location<bi}{bi> "<a}{bi> target<bi}{b>perlu<b}:{i> "<a}{bi> target<b}{bi> target<b}{bi> target<b}{bi>perlu<i}:{i> target<i}:{i>perlu<i}:{i>
{i>
{i>“<i}dikasT){i>
"{i>).project-idproject-idproject-iddataset-id1display-name1dataset-id2display-name2dataset-id3display-name3

Parameter kueri tambahan

Untuk membuat kueri dengan parameter lain (pageSize, pageToken), tambahkan parameter tersebut ke URL:

https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/datasets?pageSize=INT

Anda juga dapat menyambungkan parameter dengan ampersand (&):

https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/datasets?filter="dataset-metadata-value&pageSize=INT&pageToken=next-page-token"

Model

Anda dapat memfilter model yang tercantum menggunakan parameter berikut:

Filter

• model_metadata - menampilkan semua model dengan jenis metadata target.

  Nilai yang tersedia

  • imageClassificationModelMetadata:* (AutoML Vision - Klasifikasi Gambar)
  • imageObjectDetectionModelMetadata:* (AutoML Vision - Deteksi Objek)
  • textClassificationModelMetadata:* (AutoML Natural Language - Klasifikasi)
  • textExtractionModelMetadata:* (AutoML Natural Language - Ekstraksi Entity)
  • textSentimentModelMetadata:* (AutoML Natural Language - Analisis Sentimen)
  • translationModelMetadata:* (Terjemahan AutoML)
• datasetId - menampilkan semua model yang dibuat dari set data tertentu.

Parameter kueri tambahan

• pageSize - Membatasi hasil yang ditampilkan ke sejumlah baris tertentu. Jika tidak ditentukan, server akan memilih ukuran default.
• pageToken - Token untuk mengambil halaman hasil berikutnya. Kueri awal dengan kumpulan pageSize dan hasil yang lebih besar dari yang dapat dimuat di ukuran halaman juga akan menampilkan nextPageToken. Token ini kemudian dapat diteruskan ke pageToken untuk mendapatkan hasil berikutnya.

Contoh kode command line berikut menunjukkan cara memfilter model yang tercantum dengan menentukan model_metadata.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• project-id: project Google Cloud Platform Anda ID.
• model-metadata-value: jenis model_metadata yang Anda filter. Nilai ini bergantung pada jenis masalah AutoML.

Metode HTTP dan URL:

GET https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/models?filter="model-metadata-value"

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: project-id" \
     "https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/models?filter="model-metadata-value""

PowerShell

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "project-id" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/models?filter="model-metadata-value"" | Select-Object -Expand Content

Jika permintaan berhasil, server akan menampilkan kode status HTTP 200 OK dan respons dalam format JSON.

Respons berikut berasal dari project dengan beberapa jenis model AutoML, difilter untuk model AutoML Natural Language (?filter="textClassificationModelMetadata:*").

Respons

 {
 "KELOMPOK
"build2:"{i>library <i}"
{i>“<a class11:15 class1:
"{i> resource class<i}:
"{i>library<i}1: {i>"<i}="{i> resource<i}-{i>library<i}project-idproject-idproject-idmodel-id1display-name1dataset-iddataset-iddataset-idmodel-id2display-name2display-name2model-id3

Parameter kueri tambahan

Untuk membuat kueri dengan parameter lain (pageSize, pageToken), tambahkan parameter tersebut ke URL:

https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/models?pageSize=INT

Anda juga dapat menyambungkan parameter dengan ampersand (&):

https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/models?filter="model-metadata-value&pageSize=INT&pageToken=next-page-token"

modelEvaulations

Anda dapat memfilter evaluasi model yang tercantum menggunakan parameter berikut:

Filter

• annotationSpecId - menampilkan semua evaluasi model dengan ID yang sama dengan nilai yang diberikan. Anda juga dapat menentukan evaulasi model yang tidak sama dengan (!=) dengan nilai tertentu.

Parameter kueri tambahan

• pageSize - Membatasi hasil yang ditampilkan ke sejumlah baris tertentu. Jika tidak ditentukan, server akan memilih ukuran default.
• pageToken - Token untuk mengambil halaman hasil berikutnya. Kueri awal dengan kumpulan pageSize dan hasil yang lebih besar dari yang dapat dimuat di ukuran halaman juga akan menampilkan nextPageToken. Token ini kemudian dapat diteruskan ke pageToken untuk mendapatkan hasil berikutnya.

Contoh kode command line berikut menunjukkan cara memfilter evaluasi model yang tercantum dengan menentukan annotationSpecId.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• project-id: project Google Cloud Platform Anda ID.
• model-id: ID model yang ingin Anda evaluasi.
• annotation-spec-id: ID spesifikasi anotasi tempat evaluasi model diterapkan. ID ini kosong untuk evaluasi model secara keseluruhan.

Metode HTTP dan URL:

GET https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/models/model-id/modelEvaluations?filter="annotationSpecId=annotation-spec-id"

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: project-id" \
     "https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/models/model-id/modelEvaluations?filter="annotationSpecId=annotation-spec-id""

PowerShell

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "project-id" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/models/model-id/modelEvaluations?filter="annotationSpecId=annotation-spec-id"" | Select-Object -Expand Content

Jika permintaan berhasil, server akan menampilkan kode status HTTP 200 OK dan respons dalam format JSON.

Respons berikut berasal dari project dengan beberapa jenis model AutoML, yang difilter untuk evaluasi model dari satu model (?filter="annotationSpecId=1231173747155664896").

Respons

"4: >";project-idmodel-idmodel-evaluation-id

Parameter kueri tambahan

Untuk membuat kueri dengan parameter lain (pageSize, pageToken), tambahkan parameter tersebut ke URL:

https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/model/model-id/modelEvaluations?pageSize=INT

Anda juga dapat menyambungkan parameter dengan ampersand (&):

https://automl.googleapis.com/v1/projects/project-id/locations/us-central1/model/model-id/modelEvaluations?filter="annotationSpecId=annotation-spec-id&pageSize=INT&pageToken=next-page-token"