常見問題

誰可以存取結構化資料檔案 (SDF) 上傳 API 試用版功能?

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

哪些 API 版本支援先導功能?

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

試用版支援哪些 SDF 版本?

使用 SDF 上傳 API 搶先版時,建議使用 SDF v9.2 版。 如要從 SDF v9 之前的版本遷移,請參閱 v9 遷移指南

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

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

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

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

支援哪些用戶端程式庫?

只有 Google API Python 專用用戶端程式庫可用來存取 { api_name } 搶先體驗功能。請參閱設定步驟,建立可使用試用功能的授權服務物件。

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

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

上傳的 SDF 數量是否有限制?

Google Cloud 專案每天只能透過 Display & Video 360 API,為每個廣告主上傳 30 個結構化資料檔案。「1 天」是從美國太平洋時區 (PST) 的午夜算起。

如果 advertisers.sdfuploadtasks.upload 要求失敗,或上傳 `Operation 發生錯誤而完成,系統不會將嘗試次數計入相關配額。

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

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

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

為什麼我收到 429 錯誤訊息?

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

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