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)

ระดับการเข้าถึงข้อมูลเมตา ข้อมูลเมตาของนักพัฒนาแอปต้องมีการระบุระดับการมองเห็นเสมอ

DeveloperMetadataLocation

ตำแหน่งที่อาจเชื่อมโยงข้อมูลเมตาในสเปรดชีต

การแสดง 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)

ประเภทสถานที่ตั้งที่ออบเจ็กต์นี้แสดง ช่องนี้เป็นแบบอ่านอย่างเดียว
ฟิลด์ Union location ตำแหน่งที่เชื่อมโยงข้อมูลเมตา location ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
spreadsheet

boolean

เป็นจริงเมื่อข้อมูลเมตาเชื่อมโยงกับสเปรดชีตทั้งแผ่น
sheetId

integer

รหัสของชีตเมื่อเชื่อมโยงข้อมูลเมตากับชีตทั้งแผ่น
dimensionRange

object (DimensionRange)

แสดงแถวหรือคอลัมน์เมื่อเชื่อมโยงข้อมูลเมตากับมิติข้อมูล DimensionRange ที่ระบุต้องแสดงเป็นแถวหรือคอลัมน์เดียว โดยต้องไม่เป็นแบบไม่จำกัดหรือครอบคลุมหลายแถวหรือคอลัมน์

DeveloperMetadataLocationType

การแจงนับประเภทของตำแหน่งที่อาจเชื่อมโยงข้อมูลเมตาของนักพัฒนาซอฟต์แวร์

Enum
DEVELOPER_METADATA_LOCATION_TYPE_UNSPECIFIED ค่าเริ่มต้น
ROW ข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่เชื่อมโยงกับมิติข้อมูลทั้งแถว
COLUMN ข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่เชื่อมโยงกับมิติข้อมูลคอลัมน์ทั้งหมด
SHEET ข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่เชื่อมโยงกับทั้งชีต
SPREADSHEET ข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่เชื่อมโยงกับสเปรดชีตทั้งหมด

DeveloperMetadataVisibility

การแจงนับระดับการมองเห็นข้อมูลเมตาที่เป็นไปได้

Enum
DEVELOPER_METADATA_VISIBILITY_UNSPECIFIED ค่าเริ่มต้น
DOCUMENT ข้อมูลเมตาที่มองเห็นได้ในเอกสารจะเข้าถึงได้จากโปรเจ็กต์ของนักพัฒนาซอฟต์แวร์ที่มีสิทธิ์เข้าถึงเอกสาร
PROJECT ข้อมูลเมตาที่มองเห็นได้ในโปรเจ็กต์จะแสดงและเข้าถึงได้เฉพาะโปรเจ็กต์ของนักพัฒนาซอฟต์แวร์ที่สร้างข้อมูลเมตาดังกล่าว

เมธอด

get

 แสดงข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่มีรหัสตามที่ระบุ
แสดงผลข้อมูลเมตานักพัฒนาแอปทั้งหมดที่ตรงกับ DataFilter ที่ระบุ