區域分類器

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

以下是 Google Drive API 隨附的區域分類器清單:

rect

2D 圖片中的矩形。

屬性 說明 類型
x X 軸上的位置,圖片的預設單位為像素,PDF 則為百分比。 雙人床
y Y 軸上的位置,圖片的預設單位為像素,PDF 則為百分比。 雙人床
w X 軸上的長度,圖片的預設單位為像素,PDF 的預設單位為百分比。 雙人床
h Y 軸上的長度,圖片的預設單位為像素,PDF 的預設單位為百分比。 雙人床
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 = 分鐘,m = 毫秒;小時和分鐘為選用項目)
d 時間範圍的長度。 hh:MM:ss:mmm 格式化時間字串 (其中 M = 分鐘,m = 毫秒)
md 文件的完整時間長度。 hh:MM:ss:mmm 格式化時間字串 (其中 M = 分鐘,m = 毫秒)
txt

文件中的一段文字。

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

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

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

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

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