Chúng tôi đang cập nhật YouTube Analytics và API Báo cáo để phù hợp với cách YouTube tính số lượt xem video ngắn.
Tìm hiểu thêm
Method jobs.get
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Truy xuất thông tin về một công việc báo cáo cụ thể đã được lên lịch cho một kênh hoặc chủ sở hữu nội dung.
Yêu cầu
Yêu cầu HTTP
GET https://youtubereporting.googleapis.com/v1/jobs/{jobId}
Ủy quyền
Mọi yêu cầu gửi đến YouTube Reporting API đều phải được cho phép. Hướng dẫn uỷ quyền giải thích cách sử dụng giao thức OAuth 2.0 để truy xuất mã thông báo uỷ quyền.
Các yêu cầu gửi đến API Báo cáo của YouTube sử dụng các phạm vi uỷ quyền sau:
Phạm vi |
https://www.googleapis.com/auth/yt-analytics.readonly |
Xem báo cáo YouTube Analytics dành cho nội dung trên YouTube. Phạm vi này cung cấp quyền truy cập vào các chỉ số về hoạt động của người dùng, chẳng hạn như số lượt xem và số lượt xếp hạng. |
https://www.googleapis.com/auth/yt-analytics-monetary.readonly |
Xem các báo cáo tài chính của YouTube Analytics cho nội dung trên YouTube. Phạm vi này cung cấp quyền truy cập vào các chỉ số về hoạt động của người dùng, cũng như các chỉ số về doanh thu ước tính và hiệu suất quảng cáo. |
Thông số
Tham số đường dẫn
Thông số |
jobId |
string
Mã mà YouTube sử dụng để xác định duy nhất công việc đang được truy xuất. |
Tham số truy vấn
Thông số |
onBehalfOfContentOwner |
string
Mã nhận dạng của chủ sở hữu nội dung mà bạn đang gửi yêu cầu API. Nếu yêu cầu không chỉ định giá trị cho tham số này, thì máy chủ API sẽ giả định rằng yêu cầu đang được thực hiện cho kênh của chính người dùng. |
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa tài nguyên Công việc.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-05-08 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-05-08 UTC."],[[["This endpoint retrieves details about a specific reporting job identified by its `jobId`."],["Authorization is required for all requests, using either `https://www.googleapis.com/auth/yt-analytics.readonly` or `https://www.googleapis.com/auth/yt-analytics-monetary.readonly` scopes."],["The `jobId` is a required path parameter, identifying the specific job to retrieve."],["The optional `onBehalfOfContentOwner` query parameter specifies the content owner for the request, otherwise defaults to the user's channel."],["A successful request returns a `Job` resource in the response body, and the request body itself must be empty."]]],["The content details retrieving a scheduled reporting job's information via the YouTube Reporting API. A `GET` request is made to `https://youtubereporting.googleapis.com/v1/jobs/{jobId}` using OAuth 2.0 authorization. The request requires a `jobId` path parameter and can include an optional `onBehalfOfContentOwner` query parameter. Authorization requires specific scopes like `yt-analytics.readonly` or `yt-analytics-monetary.readonly`. A successful request returns a `Job` resource, and the request body must remain empty.\n"]]