對特定頻道張貼公告。(提交要求的使用者必須獲得授權,才能代表頻道採取行動)。
注意:雖然 activity
資源可包含使用者評分資訊 (例如使用者為影片評分或將影片標示為最愛),但您還是必須使用其他 API 方法產生這些 activity
資源。例如,您可以使用 API 的 videos.rate()
方法為影片評分,並使用 playlistItems.insert()
方法將影片標示為最愛。
配額影響:呼叫此方法的配額費用為 50 單位。
要求
HTTP 要求
POST https://www.googleapis.com/youtube/v3/activities
授權
此要求需要至少具備下列其中一個範圍的授權 (進一步瞭解驗證和授權)。
範圍 |
---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
參數
下表列出這項查詢支援的參數。上方列出的所有參數都是查詢參數。
參數 | ||
---|---|---|
必要參數 | ||
part |
string 在這項作業中, part 參數有兩個用途。它會識別寫入作業將設定的屬性,以及 API 回應將包含的屬性。以下清單包含可在參數值中加入的 part 名稱:
|
要求主體
在要求主體中提供活動資源。 這項資源:
-
您必須指定這些屬性的值:
snippet.description
-
您可以設定以下屬性的值:
snippet.description
contentDetails.bulletin.resourceId
回應
如果成功,此方法會在回應主體中傳回活動資源。
錯誤
下表說明 API 在回應此方法時可能傳回的錯誤訊息。詳情請參閱錯誤訊息說明文件。
錯誤類型 | 錯誤詳細資料 | 說明 |
---|---|---|
badRequest (400) |
bulletinTextRequired |
要求必須使用 snippet 物件的 description 屬性來提供公告文章的文字。 |
badRequest (400) |
invalidMetadata |
kind 屬性與提供的 ID 類型不符。 |
forbidden (403) |
forbidden |
要求未獲適當授權。 |
notFound (404) |
playlistNotFound |
YouTube 無法找到您嘗試與公告內容建立關聯的影片。請檢查 contentDetails.bulletinPosted.playlistId 屬性的值。 |
notFound (404) |
videoNotFound |
YouTube 無法找到您嘗試與公告內容建立關聯的影片。請檢查 contentDetails.bulletinPosted.videoId 屬性的值。 |
userRateLimitExceeded (403) |
rateLimitExceeded |
由於您已超過配額,因此無法完成這項要求。 |