Activities: insert
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
YouTube에서 채널 게시판 기능을 지원 중단했으며 이 메서드는 더 이상 지원되지 않습니다.
자세한 내용은
YouTube 고객센터를 참고하세요.
특정 채널의 게시판을 게시합니다. (요청을 제출하는 사용자는 채널을 대신하여 조치를 취할 권한이 있어야 합니다.)
참고: activity 리소스에는 사용자가 동영상을 평가하거나 동영상을 즐겨찾기로 표시하는 등의 작업에 관한 정보가 포함될 수 있지만 이러한 activity 리소스를 생성하려면 다른 API 메서드를 사용해야 합니다. 예를 들어 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 이름이 포함되어 있습니다.
contentDetailsidsnippet
|
요청 본문
요청 본문에 활동 리소스를 제공합니다.
해당 리소스의 경우:
-
다음 속성에 값을 지정해야 합니다.
-
다음 속성에 값을 설정할 수 있습니다.
snippet.descriptioncontentDetails.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 |
할당량을 초과했기 때문에 요청을 완료할 수 없습니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-21(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-21(UTC)"],[[["\u003cp\u003eYouTube's channel bulletin feature has been deprecated and is no longer supported.\u003c/p\u003e\n"],["\u003cp\u003eCreating an activity requires authorization with specific scopes, such as \u003ccode\u003ehttps://www.googleapis.com/auth/youtube\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/youtube.force-ssl\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003epart\u003c/code\u003e parameter in the request specifies which properties will be modified and included in the API response, such as \u003ccode\u003econtentDetails\u003c/code\u003e, \u003ccode\u003eid\u003c/code\u003e, and \u003ccode\u003esnippet\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must include an activity resource, and it is required to provide a value for \u003ccode\u003esnippet.description\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThis method call has a quota cost of 50 units, and exceeding the quota will result in a \u003ccode\u003euserRateLimitExceeded\u003c/code\u003e error.\u003c/p\u003e\n"]]],["The YouTube channel bulletin feature is deprecated. The API's `activities.insert` method allows posting to a channel. This requires authorization and has a quota cost of 50 units. You must provide `snippet.description` for the bulletin text in the request body. Key parameters include `part`, and the response returns an `activity` resource. Errors can occur due to bad requests, invalid metadata, authorization issues, or exceeding quota limits.\n"],null,[]]
