REST Resource: spreadsheets.developerMetadata

Ресурс: DeveloperMetadata

Метаданные разработчика, связанные с местоположением или объектом в электронной таблице. Метаданные разработчика могут использоваться для связывания произвольных данных с различными частями электронной таблицы и останутся связанными в этих местах при их перемещении и редактировании электронной таблицы. Например, если метаданные разработчика связаны со строкой 5, а затем над строкой 5 впоследствии вставляется другая строка, эти исходные метаданные по-прежнему будут связаны со строкой, с которой они были сначала связаны (теперь это строка 6). Если связанный объект удаляется, его метаданные также удаляются.

JSON-представление
{
  "metadataId": integer,
  "metadataKey": string,
  "metadataValue": string,
  "location": {
    object (DeveloperMetadataLocation)
  },
  "visibility": enum (DeveloperMetadataVisibility)
}
Поля
metadataId

integer

Уникальный идентификатор в области таблицы, идентифицирующий метаданные. Идентификаторы могут быть указаны при создании метаданных, в противном случае они будут сгенерированы и назначены случайным образом. Должно быть позитивным.

metadataKey

string

Ключ метаданных. В электронной таблице может быть несколько метаданных с одним и тем же ключом. В метаданных разработчика всегда должен быть указан ключ.

metadataValue

string

Данные, связанные с ключом метаданных.

location

object ( DeveloperMetadataLocation )

Местоположение, с которым связаны метаданные.

visibility

enum ( DeveloperMetadataVisibility )

Видимость метаданных. Метаданные разработчика всегда должны иметь указанную видимость.

РазработчикМетаданныеМестоположение

Место, где метаданные могут быть связаны в электронной таблице.

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.
}
Поля
locationType

enum ( DeveloperMetadataLocationType )

Тип местоположения, который представляет этот объект. Это поле доступно только для чтения.

location поля Союза. Местоположение, с которым связаны метаданные. location может быть только одним из следующих:
spreadsheet

boolean

Истинно, если метаданные связаны со всей электронной таблицей.

sheetId

integer

Идентификатор листа, если метаданные связаны со всем листом.

dimensionRange

object ( DimensionRange )

Представляет строку или столбец, если метаданные связаны с измерением. Указанный DimensionRange должен представлять одну строку или столбец; он не может быть неограниченным или охватывать несколько строк или столбцов.

РазработчикМетаданныеLocationType

Перечисление типов местоположений, с которыми могут быть связаны метаданные разработчика.

Перечисления
DEVELOPER_METADATA_LOCATION_TYPE_UNSPECIFIED Значение по умолчанию.
ROW Метаданные разработчика, связанные со всем измерением строки.
COLUMN Метаданные разработчика, связанные со всем измерением столбца.
SHEET Метаданные разработчика, связанные со всем листом.
SPREADSHEET Метаданные разработчика, связанные со всей электронной таблицей.

РазработчикМетаданныеВидимость

Перечень возможных возможностей видимости метаданных.

Перечисления
DEVELOPER_METADATA_VISIBILITY_UNSPECIFIED Значение по умолчанию.
DOCUMENT Метаданные, видимые в документе, доступны из любого проекта разработчика, имеющего доступ к документу.
PROJECT Метаданные, видимые для проекта, видны и доступны только проекту разработчика, создавшему метаданные.

Методы

get

 Возвращает метаданные разработчика с указанным идентификатором.
Возвращает все метаданные разработчика, соответствующие указанному DataFilter .