區域分類器

區域分類器會指定物件的格式和位置。分類器可能是圖片的 2D 矩形、文件中的一行文字、影片的時間長度等等。如要定義區域,請選取與您要使用的內容類型相符的區域分類器。舉例來說,如果您的內容是文字,則可能需要使用 txtline 區域分類器。如需區域分類器的範例,請參閱管理留言和回覆

以下是 Google Drive API 內含的區域分類器清單:

rect

2D 圖片中的矩形。

屬性 說明 類型
x 在 x 軸上的位置,單位預設為圖片的像素和 PDF 的百分比。 雙人床
y Y 軸的位置,預設單位為圖片像素和 PDF 的百分比。 雙人床
w x 軸上的長度,圖片的預設單位為像素,PDF 的預設單位為百分比。 雙人床
h Y 軸的長度,單位預設為圖片像素和百分比。 雙人床
mw 有人加註時,文件的完整寬度。使用這個方法可讓 xw 無單位,因為這兩者可視為百分比。 雙人床
mh 註解時的文件完整高度。如要瞭解用途,請參閱上述 mw 雙人床
r 文件的旋轉角度。舉例來說,如果圖片將順時針旋轉 90 度,圖片右上角會顯示 0,0 點的矩形。應為 0、90、180 或 270。 雙人床
page

PDF、TIFF 或其他有頁面的文件中的頁碼。適用於含有頁面類元素 (例如試算表、投影片或圖層) 的文件。

屬性 說明 類型
p 頁碼 (0 為索引)。 整數
mp 此文件的頁數。 整數
time

影片或其他具有時間維度的文件中的時間長度。

屬性 說明 類型
t 開始時間。 hh:MM:ss.frac 格式的時間字串 (其中 M = minutes、m = millis;小時和分鐘為選填)
d 時間範圍的長度。 hh:MM:ss:mmm 格式的時間字串 (M = minutes、m = millis)
md 文件的完整時間長度。 hh:MM:ss:mmm 格式化的時間字串 (其中 M = 分鐘,m = 毫秒)
txt

文件中的文字範圍。

屬性 說明 類型
o 開始偏移 (從檔案開頭開始的字元偏移)。 整數
l 文字範圍的長度。 整數
ml 這份文件的長度 (以字元計算)。 整數
line

文字檔案或任何包含行的檔案中的特定行。

屬性 說明 類型
n 行號。 整數
l 線條範圍的長度。 整數
ml 檔案中的行數上限。 整數
matrix

矩陣式結構中的某個位置。用於定義試算表文件或任何具有列或欄結構的文件中的列和欄。

屬性 說明 類型
c 資料欄編號。 整數
r 資料列編號。 整數
w 欄數。 整數
h 資料列數量。 整數
mw 最大寬度。 整數
mh 高度上限。 整數