REST Resource: projects.locations.notebooks.sources

Resource: Source

Sumber mewakili satu sumber konten.

Representasi JSON 
{
  "name": string,
  "title": string,
  "sourceId": {
    object (SourceId)
  },
  "metadata": {
    object (SourceMetadata)
  },
  "settings": {
    object (SourceSettings)
  }
}
Kolom
name

string

ID. Nama lengkap resource sumber. Format: projects/{project}/locations/{location}/notebooks/{notebook}/sources/{sourceId}.

Kolom ini harus berupa string berenkode UTF-8 dengan batas panjang 1.024 karakter.
title

string

Opsional. Judul sumber.
sourceId

object (SourceId)

Opsional. Hanya output. ID sumber, yang merupakan segmen terakhir dari nama resource sumber.
metadata

object (SourceMetadata)

Hanya output. metadata tentang sumber.
settings

object (SourceSettings)

Hanya output. status sumber, dan alasan kegagalan.

SourceMetadata

Mewakili metadata sumber dan beberapa informasi tambahan.

Representasi JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "googleDocsMetadata": {
    object (GoogleDocsSourceMetadata)
  },
  "youtubeMetadata": {
    object (YoutubeMetadata)
  },
  "agentspaceMetadata": {
    object (AgentspaceMetadata)
  }
  // End of mutually exclusive fields.
  "wordCount": integer,
  "tokenCount": integer,
  "sourceAddedTimestamp": string
}
Kolom
Metadata untuk sumber. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
googleDocsMetadata

object (GoogleDocsSourceMetadata)

metadata untuk sumber dokumen google.
youtubeMetadata

object (YoutubeMetadata)

metadata untuk sumber video YouTube.
agentspaceMetadata

object (AgentspaceMetadata)

metadata untuk sumber agentspace.
Akhir kolom yang saling eksklusif.
wordCount

integer

Jumlah kata sumber.
tokenCount

integer

Jumlah token dalam sumber.
sourceAddedTimestamp

string (Timestamp format)

Stempel waktu saat sumber ditambahkan.

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".

GoogleDocsSourceMetadata

metadata tentang sumber dokumen google.

Representasi JSON 
{
  "documentId": string,
  "revisionId": string
}
Kolom
documentId

string

Hanya output. ID dokumen Dokumen Google.
revisionId

string

Hanya output. ID revisi untuk dokumen.

YoutubeMetadata

metadata tentang sumber video YouTube.

Representasi JSON 
{
  "videoId": string,
  "channelName": string
}
Kolom
videoId

string

Hanya output. ID video YouTube.
channelName

string

Hanya output. Nama channel video YouTube.

AgentspaceMetadata

metadata tentang sumber ruang agen.

Representasi JSON 
{
  "documentName": string,
  "documentTitle": string
}
Kolom
documentName

string

Hanya output. Nama lengkap dokumen di Agentspace.
documentTitle

string

Hanya output. Judul dokumen.

SourceSettings

Memungkinkan perluasan Setelan Sumber di sources.batchCreate (sebelumnya permintaan AddSource).

Representasi JSON 
{
  "status": enum (SourceStatus),
  "failureReason": {
    object (FailureReason)
  }
}
Kolom
status

enum (SourceStatus)

status sumber.
failureReason

object (FailureReason)

Alasan kegagalan yang berisi detail tentang alasan sumber gagal melakukan penyerapan.

SourceStatus

Daftar kemungkinan status untuk sumber.

Enum
SOURCE_STATUS_UNSPECIFIED Status tidak ditentukan.
SOURCE_STATUS_PENDING Sumber sedang menunggu untuk ditambahkan.
SOURCE_STATUS_COMPLETE Penambahan sumber selesai dan berhasil.
SOURCE_STATUS_ERROR Penambahan sumber gagal secara permanen.
SOURCE_STATUS_PENDING_DELETION Sumber sedang menunggu penghapusan.
SOURCE_STATUS_TENTATIVE Pengguna mencoba menambahkan sumber, tetapi kami belum menguploadnya atau memeriksa batas pengguna. Tidak diperhitungkan dalam batas sumber pengguna.

FailureReason

Alasan kegagalan yang berisi detail tentang alasan sumber gagal melakukan penyerapan.

Representasi JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "unknown": {
    object (Unknown)
  },
  "sourceTooLong": {
    object (SourceTooLong)
  },
  "ingestionError": {
    object (IngestionError)
  },
  "sourceEmpty": {
    object (SourceEmpty)
  },
  "uploadError": {
    object (UploadError)
  },
  "paywallError": {
    object (PaywallError)
  },
  "sourceUnreachable": {
    object (SourceUnreachable)
  },
  "googleDriveError": {
    object (GoogleDriveError)
  },
  "youtubeError": {
    object (YoutubeError)
  },
  "audioTranscriptionError": {
    object (AudioTranscriptionError)
  },
  "sourceLimitExceeded": {
    object (SourceLimitExceeded)
  },
  "domainBlocked": {
    object (DomainBlocked)
  },
  "mimeTypeBlocked": {
    object (MimeTypeBlocked)
  },
  "policyCheckFailed": {
    object (PolicyCheckFailed)
  }
  // End of mutually exclusive fields.
}
Kolom
Error spesifik. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
unknown

object (Unknown)

Menunjukkan bahwa terjadi error yang tidak diketahui.
sourceTooLong

object (SourceTooLong)

Menunjukkan jumlah kata sumber melebihi batas pengguna.
ingestionError

object (IngestionError)

Menunjukkan bahwa terjadi error saat memproses sumber.
sourceEmpty

object (SourceEmpty)

Menunjukkan bahwa sumber kosong.
uploadError

object (UploadError)

Menunjukkan bahwa terjadi error saat mengupload sumber.
paywallError

object (PaywallError)

Menunjukkan bahwa sumber dibatasi konten berbayar dan tidak dapat di-ingest.
sourceUnreachable

object (SourceUnreachable)

Menunjukkan bahwa sumber tidak dapat dijangkau.
googleDriveError

object (GoogleDriveError)

Error khusus google drive.
youtubeError

object (YoutubeError)

Error khusus YouTube.
audioTranscriptionError

object (AudioTranscriptionError)

Error khusus transkripsi file audio.
sourceLimitExceeded

object (SourceLimitExceeded)

Error jika pengguna mencoba memperbarui di luar batasnya.
domainBlocked

object (DomainBlocked)

Error jika pengguna mencoba menambahkan sumber dari domain yang diblokir.
mimeTypeBlocked

object (MimeTypeBlocked)

Menunjukkan bahwa jenis MIME sumber diblokir.
policyCheckFailed

object (PolicyCheckFailed)

Menunjukkan bahwa pemeriksaan kebijakan gagal.
Akhir kolom yang saling eksklusif.

Tidak diketahui

Jenis ini tidak memiliki kolom.

Menunjukkan bahwa terjadi error yang tidak diketahui.

SourceTooLong

Menunjukkan jumlah kata sumber melebihi batas pengguna.

Representasi JSON 
{
  "wordCount": integer,
  "wordLimit": integer
}
Kolom
wordCount

integer

Jumlah kata dalam sumber.
wordLimit

integer

Batas jumlah kata untuk pengguna saat ini pada saat upload.

IngestionError

Jenis ini tidak memiliki kolom.

Menunjukkan bahwa terjadi error saat memproses sumber.

SourceEmpty

Jenis ini tidak memiliki kolom.

Menunjukkan bahwa sumber kosong.

UploadError

Jenis ini tidak memiliki kolom.

Menunjukkan bahwa terjadi error saat mengupload sumber.

PaywallError

Jenis ini tidak memiliki kolom.

Menunjukkan bahwa sumber dibatasi konten berbayar dan tidak dapat di-ingest.

SourceUnreachable

Menunjukkan bahwa sumber tidak dapat dijangkau. Ini terutama digunakan untuk sumber yang ditambahkan melalui URL.

Representasi JSON 
{
  "errorDetails": enum (SourceUnreachableErrorReason)
}
Kolom
errorDetails

enum (SourceUnreachableErrorReason)

Menjelaskan alasan sumber tidak dapat dijangkau.

SourceUnreachableErrorReason

Detail alasan sumber tidak dapat dijangkau. Digunakan untuk menampilkan pesan yang sesuai kepada pengguna.

Enum
ERROR_REASON_UNSPECIFIED Default
ERROR_REASON_INVALID_URL URL sumber tidak valid.
ERROR_REASON_NOT_ACCESSIBLE URL sumber tidak dapat diakses.
ERROR_REASON_NOT_REACHABLE URL sumber tidak dapat dijangkau.
ERROR_REASON_URL_NOT_FOUND URL sumber menampilkan 404.
ERROR_REASON_TRANSIENT_ERROR URL sumber tidak dapat dijangkau karena error jaringan sementara atau waktu tunggu host habis, dll.
ERROR_REASON_FETCH_FAILED URL sumber tidak dapat diambil karena terjadi error internal.
ERROR_REASON_NOT_SUPPORTED URL belum didukung. Contohnya mencakup: konten yang diambil melebihi ukuran maksimum pengambilan data crawler, konten yang diambil adalah jenis yang belum kami dukung, dll.

GoogleDriveError

Error khusus google drive.

Representasi JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "downloadPrevented": {
    object (DownloadPrevented)
  }
  // End of mutually exclusive fields.
}
Kolom
Error khusus Drive. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
downloadPrevented

object (DownloadPrevented)

Pengguna dicegah mendownload file.
Akhir kolom yang saling eksklusif.

DownloadPrevented

Jenis ini tidak memiliki kolom.

Pengguna dicegah mendownload file.

YoutubeError

Error khusus YouTube.

Representasi JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "videoDeleted": {
    object (VideoDeleted)
  }
  // End of mutually exclusive fields.
}
Kolom
Error khusus YouTube. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
videoDeleted

object (VideoDeleted)

Error untuk menunjukkan bahwa sumber dihapus karena video telah dihapus.
Akhir kolom yang saling eksklusif.

VideoDeleted

Jenis ini tidak memiliki kolom.

Error untuk menunjukkan bahwa sumber dihapus karena video telah dihapus.

AudioTranscriptionError

Error khusus transkripsi file audio.

Representasi JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "languageDetectionFailed": {
    object (LanguageDetectionFailed)
  },
  "noAudioDetected": {
    object (NoAudioDetected)
  }
  // End of mutually exclusive fields.
}
Kolom
Error spesifik transkripsi file audio. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
languageDetectionFailed

object (LanguageDetectionFailed)

Tidak dapat mendeteksi bahasa file (mungkin bukan ucapan).
noAudioDetected

object (NoAudioDetected)

Tidak ada audio yang terdeteksi dalam file input (mungkin berupa video).
Akhir kolom yang saling eksklusif.

LanguageDetectionFailed

Jenis ini tidak memiliki kolom.

Tidak dapat mendeteksi bahasa file (mungkin bukan ucapan).

NoAudioDetected

Jenis ini tidak memiliki kolom.

Tidak ada audio yang terdeteksi dalam file input.

SourceLimitExceeded

Jenis ini tidak memiliki kolom.

Menunjukkan bahwa pengguna tidak memiliki ruang untuk sumber ini.

DomainBlocked

Jenis ini tidak memiliki kolom.

Error untuk menunjukkan bahwa sumber dihapus karena domain diblokir.

MimeTypeBlocked

Jenis ini tidak memiliki kolom.

Menunjukkan bahwa jenis MIME sumber diblokir.

PolicyCheckFailed

Jenis ini tidak memiliki kolom.

Menunjukkan bahwa pemeriksaan kebijakan gagal.

Metode

batchCreate

 Membuat daftar Source.

batchDelete

 Menghapus beberapa sumber

get

 Mendapatkan Source.