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 ที่ระบุ