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