REST Resource: spreadsheets.developerMetadata

Resource: DeveloperMetadata

Metadata developer yang terkait dengan lokasi atau objek di spreadsheet. Metadata developer dapat digunakan untuk mengaitkan data arbitrer dengan berbagai bagian spreadsheet dan akan tetap dikaitkan di lokasi tersebut saat mereka berpindah dan spreadsheet diedit. Misalnya, jika metadata developer dikaitkan dengan baris 5 dan baris lain disisipkan di atas baris 5, metadata asli tersebut akan tetap dikaitkan dengan baris yang pertama kali dikaitkan dengannya (sekarang disebut baris 6). Jika objek terkait dihapus, metadatanya juga akan dihapus.

Representasi JSON
{
  "metadataId": integer,
  "metadataKey": string,
  "metadataValue": string,
  "location": {
    object (DeveloperMetadataLocation)
  },
  "visibility": enum (DeveloperMetadataVisibility)
}
Kolom
metadataId

integer

ID unik cakupan spreadsheet yang mengidentifikasi metadata. ID dapat ditentukan saat metadata dibuat. Jika tidak, satu ID akan dibuat dan ditetapkan secara acak. Harus positif.

metadataKey

string

Kunci metadata. Mungkin ada beberapa metadata dalam spreadsheet dengan kunci yang sama. Metadata developer harus selalu memiliki kunci yang ditentukan.

metadataValue

string

Data yang terkait dengan kunci metadata.

location

object (DeveloperMetadataLocation)

Lokasi tempat metadata dikaitkan.

visibility

enum (DeveloperMetadataVisibility)

Visibilitas metadata. Metadata developer harus selalu memiliki visibilitas yang ditentukan.

LokasiMetadataDeveloper

Lokasi tempat metadata dapat dikaitkan dalam spreadsheet.

Representasi JSON
{
  "locationType": enum (DeveloperMetadataLocationType),

  // Union field location can be only one of the following:
  "spreadsheet": boolean,
  "sheetId": integer,
  "dimensionRange": {
    object (DimensionRange)
  }
  // End of list of possible types for union field location.
}
Kolom
locationType

enum (DeveloperMetadataLocationType)

Jenis lokasi yang diwakili oleh objek ini. Kolom ini bersifat hanya baca.

Kolom union location. Lokasi tempat metadata dikaitkan. location hanya dapat berupa salah satu dari berikut:
spreadsheet

boolean

Benar jika metadata dikaitkan dengan seluruh spreadsheet.

sheetId

integer

ID sheet saat metadata dikaitkan dengan seluruh sheet.

dimensionRange

object (DimensionRange)

Mewakili baris atau kolom saat metadata dikaitkan dengan dimensi. DimensionRange yang ditentukan harus mewakili satu baris atau kolom; tidak dapat terikat atau mencakup beberapa baris atau kolom.

DeveloperMetadataLocationType

Enumerasi jenis lokasi yang mungkin dikaitkan dengan metadata developer.

Enumerasi
DEVELOPER_METADATA_LOCATION_TYPE_UNSPECIFIED Nilai default.
ROW Metadata developer yang terkait pada seluruh dimensi baris.
COLUMN Metadata developer yang terkait di seluruh dimensi kolom.
SHEET Metadata developer yang terkait di seluruh sheet.
SPREADSHEET Metadata developer yang terkait di seluruh spreadsheet.

DeveloperMetadataVisibility

Enumerasi kemungkinan visibilitas metadata.

Enumerasi
DEVELOPER_METADATA_VISIBILITY_UNSPECIFIED Nilai default.
DOCUMENT Metadata yang terlihat dokumen dapat diakses dari project developer apa pun dengan akses ke dokumen.
PROJECT Metadata yang terlihat oleh project hanya terlihat dan dapat diakses oleh project developer yang membuat metadata tersebut.

Metode

get

Menampilkan metadata developer dengan ID yang ditentukan.
Menampilkan semua metadata developer yang cocok dengan DataFilter yang ditentukan.