REST Resource: projects

Resource: Project

Metadata dan konfigurasi untuk project Google Cloud dalam layanan.

Representasi JSON 
{
  "name": string,
  "createTime": string,
  "provisionCompletionTime": string,
  "serviceTermsMap": {
    string: {
      object (ServiceTerms)
    },
    ...
  },
  "customerProvidedConfig": {
    object (CustomerProvidedConfig)
  },
  "configurableBillingStatus": {
    object (ConfigurableBillingStatus)
  }
}
Kolom
name

string

Hanya output. Nama resource lengkap project, misalnya projects/{project}. Perhatikan bahwa saat membuat permintaan, nomor project dan project ID dapat diterima, tetapi server akan selalu merespons dalam nomor project.
createTime

string (Timestamp format)

Hanya output. Stempel waktu saat project ini dibuat.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
provisionCompletionTime

string (Timestamp format)

Hanya output. Stempel waktu saat project ini berhasil disediakan. Nilai kosong berarti project ini masih dalam penyediaan dan belum siap digunakan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
serviceTermsMap

map (key: string, value: object (ServiceTerms))

Hanya output. Peta persyaratan layanan. Kuncinya adalah id dari ServiceTerms.
customerProvidedConfig

object (CustomerProvidedConfig)

Opsional. Konfigurasi yang disediakan pelanggan.
configurableBillingStatus

object (ConfigurableBillingStatus)

Hanya output. Status saat ini dari penagihan yang dapat dikonfigurasi project.

ServiceTerms

Metadata tentang persyaratan layanan.

Representasi JSON 
{
  "id": string,
  "version": string,
  "state": enum (State),
  "acceptTime": string,
  "declineTime": string
}
Kolom
id

string

ID unik persyaratan layanan ini. Istilah yang tersedia:
version

string

String versi persyaratan layanan. Untuk mengetahui nilai yang dapat diterima, lihat komentar untuk id di atas.
state

enum (State)

Apakah project telah menyetujui/menolak persyaratan layanan atau masih menunggu keputusan.
acceptTime

string (Timestamp format)

Terakhir kali project menyetujui persyaratan layanan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
declineTime

string (Timestamp format)

Terakhir kali project menolak atau mencabut persetujuan terhadap persyaratan layanan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

Negara Bagian

Perjanjian ini menyatakan persyaratan layanan ini.

Enum
STATE_UNSPECIFIED Nilai default enum. Nilai ini sebenarnya tidak digunakan.
TERMS_ACCEPTED Project telah memberikan izin untuk persyaratan layanan.
TERMS_PENDING Project menunggu peninjauan dan persetujuan persyaratan layanan.
TERMS_DECLINED Project telah menolak atau mencabut perjanjian persyaratan layanan.

CustomerProvidedConfig

Konfigurasi yang disediakan pelanggan.

Representasi JSON 
{
  "notebooklmConfig": {
    object (NotebooklmConfig)
  }
}
Kolom
notebooklmConfig

object (NotebooklmConfig)

Opsional. Konfigurasi untuk setelan NotebookLM.

NotebooklmConfig

Konfigurasi untuk NotebookLM.

Representasi JSON 
{
  "modelArmorConfig": {
    object (ModelArmorConfig)
  },
  "optOutNotebookSharing": boolean,
  "dataProtectionPolicy": {
    object (DataProtectionPolicy)
  },
  "observabilityConfig": {
    object (ObservabilityConfig)
  }
}
Kolom
modelArmorConfig

object (ModelArmorConfig)

Konfigurasi Model Armor yang akan digunakan untuk menyaring perintah pengguna dan respons LLM.
optOutNotebookSharing

boolean

Opsional. Apakah akan menonaktifkan fitur berbagi notebook untuk project. Defaultnya adalah salah (false) jika tidak ditentukan.
dataProtectionPolicy

object (DataProtectionPolicy)

Opsional. Menentukan kebijakan perlindungan data untuk NotebookLM.
observabilityConfig

object (ObservabilityConfig)

Opsional. Konfigurasi kemampuan pengamatan untuk NotebookLM.

ModelArmorConfig

Konfigurasi untuk template Model Armor yang ditentukan pelanggan yang akan digunakan untuk membersihkan perintah pengguna dan respons LLM.

Representasi JSON 
{
  "userPromptTemplate": string,
  "responseTemplate": string
}
Kolom
userPromptTemplate

string

Opsional. Nama resource Template Model Armor untuk membersihkan perintah pengguna. Format: projects/{project}/locations/{location}/templates/{templateId} Jika tidak ditentukan, tidak ada pembersihan yang akan diterapkan pada perintah pengguna.
responseTemplate

string

Opsional. Nama resource Template Model Armor untuk menyaring respons LLM. Format: projects/{project}/locations/{location}/templates/{templateId} Jika tidak ditentukan, tidak ada pembersihan yang akan diterapkan pada respons LLM.

DataProtectionPolicy

konfigurasi kebijakan perlindungan data untuk NotebookLM.

Representasi JSON 
{
  "sensitiveDataProtectionPolicy": {
    object (SensitiveDataProtectionPolicy)
  }
}
Kolom
sensitiveDataProtectionPolicy

object (SensitiveDataProtectionPolicy)

Opsional. Kebijakan perlindungan data sensitif.

SensitiveDataProtectionPolicy

Menentukan kebijakan Sensitive Data Protection (https://cloud.google.com/sensitive-data-protection/docs/sensitive-data-protection-overview).

Representasi JSON 
{
  "policy": string
}
Kolom
policy

string

Opsional. Nama resource kebijakan Sensitive Data Protection.

ConfigurableBillingStatus

Mewakili parameter penagihan yang dapat dikonfigurasi dan saat ini berlaku. Nilai ini berasal dari histori langganan pelanggan yang disimpan secara internal dan mencerminkan nilai minimum yang aktif digunakan untuk tujuan penagihan pada saat panggilan projects.get. Ini mencakup startTime langganan dan mungkin berbeda dari nilai di customerProvidedConfig karena aturan penagihan (misalnya, penurunan skala yang berlaku hanya pada awal bulan baru). Kami juga menyertakan jenis update untuk menunjukkan jenis update yang dilakukan pada konfigurasi penagihan yang dapat dikonfigurasi dalam operasi projects.patch.

Representasi JSON 
{
  "effectiveSearchQpmThreshold": string,
  "effectiveIndexingCoreThreshold": string,
  "startTime": string,
  "terminateTime": string,
  "searchQpmThresholdNextUpdateTime": string,
  "indexingCoreThresholdNextUpdateTime": string,
  "updateType": enum (UpdateType),
  "agentSearchTokenSubscriptionStatuses": [
    {
      object (AgentSearchTokenSubscriptionStatus)
    }
  ]
}
Kolom
effectiveSearchQpmThreshold

string (int64 format)

Opsional. Nilai minimum QPM Penelusuran yang berlaku saat ini dalam kueri per menit. Ini adalah nilai minimum yang digunakan untuk membandingkan penggunaan QPM dalam penghitungan kelebihan penggunaan.
effectiveIndexingCoreThreshold

string (int64 format)

Opsional. Nilai minimum Indexing Core yang berlaku saat ini. Ini adalah nilai minimum yang digunakan untuk membandingkan penggunaan Indexing Core untuk penghitungan kelebihan penggunaan.
startTime

string (Timestamp format)

Opsional. Waktu mulai langganan penagihan yang saat ini aktif.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
terminateTime

string (Timestamp format)

Hanya output. Waktu efektif penghentian terbaru untuk langganan inti pengindeksan dan qpm penelusuran.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
searchQpmThresholdNextUpdateTime

string (Timestamp format)

Hanya output. Waktu update berikutnya paling awal untuk nilai minimum langganan QPM penelusuran. Hal ini didasarkan pada next_update_time yang ditampilkan oleh Cloud Billing Subscription V3 API yang mendasarinya. Kolom ini hanya diisi jika permintaan update nilai minimum langganan QPM berhasil.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
indexingCoreThresholdNextUpdateTime

string (Timestamp format)

Hanya output. Waktu update berikutnya paling awal untuk batas langganan inti pengindeksan. Hal ini didasarkan pada next_update_time yang ditampilkan oleh Cloud Billing Subscription V3 API yang mendasarinya. Kolom ini hanya diisi jika permintaan nilai minimum langganan inti pengindeksan pembaruan berhasil.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
updateType

enum (UpdateType)

Hanya output. Jenis update yang dilakukan dalam operasi ini. Kolom ini diisi dalam respons projects.patch.
agentSearchTokenSubscriptionStatuses[]

object (AgentSearchTokenSubscriptionStatus)

Hanya output. Status langganan TPM Agent Search per model.

UpdateType

Jenis update yang dilakukan pada konfigurasi penagihan yang dapat dikonfigurasi.

Enum
UPDATE_TYPE_UNSPECIFIED Jenis update tidak ditentukan.
CREATE Penagihan yang dapat dikonfigurasi dibuat/diaktifkan.
DELETE Penagihan yang dapat dikonfigurasi dihapus/dinonaktifkan.
SCALE_UP Langganan ditingkatkan (nilai minimum ditingkatkan).
SCALE_DOWN Langganan diturunkan (batas diturunkan).

AgentSearchTokenSubscriptionStatus

Status langganan TPM Agent Search per model. Satu entri per entri coreSubscription.agent_search_token_subscriptions[*] aktif dalam konfigurasi yang disediakan pelanggan; diisi oleh projects.patch dan projects.get.

Skalar siklus proses pada pesan ini (startTime, terminateTime, updateType, tpmThresholdNextUpdateTime) adalah per (project, modelVersion) — saudara dari startTime / terminateTime / updateType seluruh hubungan pada ConfigurableBillingStatus yang melampirkan, tetapi dicakup ke langganan TPM Agent Search tertentu ini, bukan ke hubungan harga yang dapat dikonfigurasi pelanggan secara keseluruhan. Granularitas per-instance ini disengaja: penyimpanan SubV3 yang mendasarinya adalah per-(project, modelVersion), sehingga setiap model memiliki aktivasi, penghentian, dan clock update yang ditangguhkan sendiri; menampilkannya dalam respons memberi pelanggan granularitas yang mereka butuhkan untuk mengelola komitmen per-model secara independen. QPM / IndexingCore berbeda — penyimpanannya adalah satu baris per (project, lokasi), sehingga siklus prosesnya hanya diwakili oleh skalar hubungan keseluruhan pada ConfigurableBillingStatus.

Representasi JSON 
{
  "modelVersion": string,
  "effectiveTpmThreshold": string,
  "tpmThresholdNextUpdateTime": string,
  "startTime": string,
  "terminateTime": string,
  "updateType": enum (UpdateType)
}
Kolom
modelVersion

string

Hanya output. Versi model Gemini yang sesuai dengan status ini. Cocok dengan CoreSubscription.AgentSearchTokenSubscription.model_version (versi model Gemini yang stabil dari registry versi model Gemini Enterprise Agent Platform; lihat https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions#gemini-models).
effectiveTpmThreshold

string (int64 format)

Hanya output. Nilai minimum TPM yang saat ini berlaku. Mencerminkan peningkatan skala secara langsung dan penurunan skala pada siklus penagihan berikutnya, yang cocok dengan semantik effectiveSearchQpmThreshold.
tpmThresholdNextUpdateTime

string (Timestamp format)

Hanya output. Waktu update berikutnya paling awal untuk nilai minimum langganan TPM untuk (project, modelVersion) ini. Diisi hanya setelah update berhasil.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
startTime

string (Timestamp format)

Hanya output. Saat langganan TPM Penelusuran Agen (project, modelVersion) ini pertama kali diaktifkan. Ditetapkan sekali pada aktivasi pertama versi model ini dan tidak pernah dipindahkan oleh pembaruan batas berikutnya; pada penghentian + pengaktifan ulang, nilai baru akan dicatat. TIDAK memindahkan startTime seluruh hubungan pada ConfigurableBillingStatus yang melampirkan, yang terus merepresentasikan aktivasi pertama dari keseluruhan hubungan penetapan harga yang dapat dikonfigurasi pelanggan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
terminateTime

string (Timestamp format)

Hanya output. Jika disetel, waktu efektif terjadwal saat langganan TPM Penelusuran Agen (project, modelVersion) ini akan berakhir. Diisi saat pelanggan menghapus entri ini dari coreSubscription.agent_search_token_subscriptions[*]. TIDAK memindahkan seluruh terminateTime hubungan pada ConfigurableBillingStatus yang melampirkan, yang diisi hanya saat seluruh hubungan harga yang dapat dikonfigurasi pelanggan dihentikan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
updateType

enum (UpdateType)

Hanya output. Jenis update terbaru untuk langganan ini (project, modelVersion), seperti yang dilakukan oleh panggilan projects.patch terbaru. UPDATE_TYPE_UNSPECIFIED menunjukkan bahwa modelVersion ini tidak disentuh oleh projects.patch terbaru (effectiveTpmThreshold-nya mencerminkan update sebelumnya). updateType hubungan keseluruhan pada ConfigurableBillingStatus yang melampirkan terus meringkas arah pembaruan terbaru di semua platform dalam project (QPM, IndexingCore, dan Agent Search TPM bersama-sama).

Metode

get

 Mendapatkan Project.

patch

 Memperbarui setelan yang dapat diedit dari Project Discovery Engine.

provision

 Menyediakan resource project.

reportConsentChange

 Memperbarui persyaratan layanan untuk project ini.