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)

ประเภทของตำแหน่งที่ออบเจ็กต์นี้แสดง ช่องนี้เป็นแบบอ่านอย่างเดียว
ฟิลด์สหภาพ 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 ที่ระบุ