Google Cloud Storage 物件建構工具介面。
透過 functions.storage.object()存取。
簽名：
export declare class ObjectBuilder
方法
| 方法 | 修飾符 | 說明 |
|---|---|---|
| onArchive(handler) | 只有在值區已啟用物件版本管理功能時，才會傳送事件處理常式。這個事件表示物件的使用中版本已變為封存版本，原因是物件遭到封存或是因為擁有相同名稱的物件上傳而遭到覆寫。 | |
| onDelete(處理常式) | 每次發生 Google Cloud Storage 刪除作業時，都會觸發事件處理常式。在物件永久刪除時傳送。值區生命週期設定中覆寫或刪除的物件也包含在內。如果值區已啟用物件版本管理功能，則在封存物件時，系統不會傳送事件，即使透過 storage.objects.delete 方法進行封存也一樣。 |
|
| onFinalize(handler) | 每次發生 Google Cloud Storage 物件時，就會觸發事件處理常式。在值區中成功建立新物件 (或現有物件的新版本) 時傳送。複製或重寫現有的物件也包含在內。上傳失敗不會觸發這個事件。 | |
| onMetadataUpdate(處理常式) | 每次現有物件的中繼資料變更時，觸發的事件處理常式。 |
storage.ObjectBuilder.onArchive()
只有在值區已啟用物件版本管理功能時，才會傳送事件處理常式。這個事件表示物件的使用中版本已變為封存版本，原因是物件遭到封存或是因為擁有相同名稱的物件上傳而遭到覆寫。
簽名：
onArchive(handler: (object: ObjectMetadata, context: EventContext) => PromiseLike<any> | any): CloudFunction<ObjectMetadata>;
參數
| 參數 | 類型 | 說明 |
|---|---|---|
| handler | (物件：ObjectMetadata，情境：EventContext) =>承諾<任何>|任何 | 每次發生 Google Cloud Storage 封存時都會執行事件處理常式。 |
傳回：
可匯出及部署的函式。
storage.ObjectBuilder.onDelete()
每次發生 Google Cloud Storage 刪除作業時觸發的事件處理常式。
當永久刪除物件時，會傳送這個事件。值區生命週期設定中覆寫或刪除的物件也包含在內。如果值區已啟用物件版本管理功能，則在封存物件時，系統不會傳送事件，即使透過 storage.objects.delete 方法進行封存也一樣。
簽名：
onDelete(handler: (object: ObjectMetadata, context: EventContext) => PromiseLike<any> | any): CloudFunction<ObjectMetadata>;
參數
| 參數 | 類型 | 說明 |
|---|---|---|
| handler | (物件：ObjectMetadata，情境：EventContext) =>承諾<任何>|任何 | 每次發生 Google Cloud Storage 刪除作業時，都會執行事件處理常式。 |
傳回：
可匯出及部署的函式。
storage.ObjectBuilder.onFinalize()
每次發生 Google Cloud Storage 物件時都會觸發的事件處理常式。
當在值區中成功建立新物件 (或現有物件的新版本) 時，會傳送這個事件。其中包含複製或重寫現有的物件。上傳失敗不會觸發這個事件。
簽名：
onFinalize(handler: (object: ObjectMetadata, context: EventContext) => PromiseLike<any> | any): CloudFunction<ObjectMetadata>;
參數
| 參數 | 類型 | 說明 |
|---|---|---|
| handler | (物件：ObjectMetadata，情境：EventContext) =>承諾<任何>|任何 | 每次發生 Google Cloud Storage 物件時，都會執行這個事件處理常式。 |
傳回：
可匯出及部署的函式。
storage.ObjectBuilder.onMetadataUpdate()
每次現有物件的中繼資料變更時，觸發的事件處理常式。
簽名：
onMetadataUpdate(handler: (object: ObjectMetadata, context: EventContext) => PromiseLike<any> | any): CloudFunction<ObjectMetadata>;
參數
| 參數 | 類型 | 說明 |
|---|---|---|
| handler | (物件：ObjectMetadata，情境：EventContext) =>承諾<任何>|任何 | 每次發生 Google Cloud Storage 中繼資料更新時，都會執行事件處理常式。 |
傳回：
可匯出及部署的函式。