常見問題

誰可以使用結構化資料檔案 (SDF) 上傳 API 前測功能?

advertisers.sdfuploadtasks.upload 方法僅適用於已加入許可清單的 Google Cloud 雲端專案。

哪些 API 版本支援試用功能?

結構化資料檔案上傳 API 試用版僅支援 Display & Video 360 API 第 4 版。

前測計畫支援哪些 SDF 版本?

使用 SDF Upload API 前測計畫時,建議您採用 SDF v9.2 以上版本。

如何判斷專案是否已加入許可清單?

在這個網址中插入專案產生的 API 金鑰,然後將網址複製並貼到瀏覽器中:

https://displayvideo.googleapis.com/$discovery/rest?version=v4&labels=SDF_UPLOAD_ALPHA&key=API_KEY

如果看到 API 的 JSON 說明,表示專案已加入許可清單。如果看到錯誤訊息,表示專案尚未新增。

支援哪些用戶端程式庫?

只有 Python 適用的 Google API 用戶端程式庫,才能用來存取 Display & Video 360 API 試用功能。請參閱設定步驟,建立可使用前測功能的授權服務物件。

SDF 的項目數量是否有限制?

SDF 的項目上限為 10,000 個。如果嘗試上傳超過這個限制的檔案,就會發生錯誤。

上傳 SDF 是否有數量限制?

Google Cloud 專案只能使用 Display & Video 360 API,為每個廣告主每天上傳三十個 SDF。一天從美國太平洋時區 (PST) 的午夜開始。

如果 advertisers.sdfuploadtasks.upload 要求失敗或上傳 Operation 發生錯誤,該次嘗試不會計入相關配額。

一次可以上傳多少個 SDF 檔案?

每個 advertisers.sdfuploadtasks.upload 要求只能上傳一個檔案。

單一 Display & Video 360 使用者一次只能處理 20 項結構化資料檔案上傳工作。如果已上傳 20 個檔案,必須等待其中一個檔案處理完畢,才能上傳下一個檔案。

為什麼我會收到 429 錯誤?

如果收到 429 錯誤,表示你可能已超過單日可上傳至廣告主的 SDF 數量上限。請等到隔天,再使用 Display & Video 360 API 上傳相關廣告主的其他 SDF。

如果您認為自己超過其他配額,請參閱標準 API 用量限制,瞭解限制定義,並參閱配額最佳化指南,瞭解限制配額用量的最佳做法。