REST Resource: projects.locations.notebooks.sources

Resource: Sumber

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 
{

  // Union field metadata can be only one of the following:
  "googleDocsMetadata": {
    object (GoogleDocsSourceMetadata)
  },
  "youtubeMetadata": {
    object (YoutubeMetadata)
  },
  "agentspaceMetadata": {
    object (AgentspaceMetadata)
  }
  // End of list of possible types for union field metadata.
  "wordCount": integer,
  "tokenCount": integer,
  "sourceAddedTimestamp": string
}
Kolom
Kolom union metadata. Metadata untuk sumber. metadata hanya ada berupa salah satu diantara berikut:
googleDocsMetadata

object (GoogleDocsSourceMetadata)

Metadata untuk sumber dokumen google.
youtubeMetadata

object (YoutubeMetadata)

metadata untuk sumber video YouTube.
agentspaceMetadata

object (AgentspaceMetadata)

Metadata untuk sumber ruang agen.
wordCount

integer

Jumlah kata dalam 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 Google Dokumen.
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 menunggu ditambahkan.
SOURCE_STATUS_COMPLETE Penambahan sumber telah 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 dihitung dalam batas sumber pengguna.

FailureReason

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

Representasi JSON 
{

  // Union field error can be only one of the following:
  "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)
  }
  // End of list of possible types for union field error.
}
Kolom
Kolom union error. Error tertentu. error hanya ada berupa salah satu diantara berikut:
unknown

object (Unknown)

Menunjukkan bahwa terjadi error yang tidak diketahui.
sourceTooLong

object (SourceTooLong)

Menunjukkan bahwa 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.

Tidak diketahui

Jenis ini tidak memiliki kolom.

Menunjukkan bahwa terjadi error yang tidak diketahui.

SourceTooLong

Menunjukkan bahwa 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 
{

  // Union field error can be only one of the following:
  "downloadPrevented": {
    object (DownloadPrevented)
  }
  // End of list of possible types for union field error.
}
Kolom
Kolom union error. Error khusus Drive. error hanya ada berupa salah satu diantara berikut:
downloadPrevented

object (DownloadPrevented)

Pengguna dicegah mendownload file.

DownloadPrevented

Jenis ini tidak memiliki kolom.

Pengguna dicegah mendownload file.

YoutubeError

Error khusus YouTube.

Representasi JSON 
{

  // Union field error can be only one of the following:
  "videoDeleted": {
    object (VideoDeleted)
  }
  // End of list of possible types for union field error.
}
Kolom
Kolom union error. Error khusus YouTube. error hanya ada berupa salah satu diantara berikut:
videoDeleted

object (VideoDeleted)

Error untuk menunjukkan bahwa sumber dihapus karena video dihapus.

VideoDeleted

Jenis ini tidak memiliki kolom.

Error untuk menunjukkan bahwa sumber dihapus karena video dihapus.

AudioTranscriptionError

Error khusus transkripsi file audio.

Representasi JSON 
{

  // Union field error can be only one of the following:
  "languageDetectionFailed": {
    object (LanguageDetectionFailed)
  },
  "noAudioDetected": {
    object (NoAudioDetected)
  }
  // End of list of possible types for union field error.
}
Kolom
Kolom union error. Error spesifik transkripsi file audio. error hanya ada berupa salah satu diantara berikut:
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).

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.

Metode

batchCreate

 Membuat daftar Source.

batchDelete

 Menghapus beberapa sumber

get

 Mendapatkan Source.