YouTube アナリティクスと Reporting API を更新し、YouTube のショート動画の視聴回数のカウント方法に合わせています。
詳細
Method jobs.get
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
チャンネルまたはコンテンツ所有者に対してスケジュールされた特定のレポートジョブに関する情報を取得します。
リクエスト
HTTP リクエスト
GET https://youtubereporting.googleapis.com/v1/jobs/{jobId}
承認
YouTube Reporting API へのすべてのリクエストは承認を受ける必要があります。認可ガイドでは、OAuth 2.0 プロトコルを使用して認可トークンを取得する方法について説明しています。
YouTube Reporting API リクエストでは、次の認可スコープが使用されます。
スコープ |
https://www.googleapis.com/auth/yt-analytics.readonly |
YouTube コンテンツの YouTube アナリティクス レポートを表示します。このスコープは再生回数や評価数など、ユーザー アクティビティの指標へのアクセスを提供します。 |
https://www.googleapis.com/auth/yt-analytics-monetary.readonly |
YouTube コンテンツに関する YouTube アナリティクス収益レポートを表示します。このスコープでは、ユーザー アクティビティの指標、推定収益と広告パフォーマンスの指標にアクセスできます。 |
パラメータ
パスパラメータ
パラメータ |
jobId |
string
YouTube が取得するジョブを一意に識別するために使用する ID。 |
クエリ パラメータ
パラメータ |
onBehalfOfContentOwner |
string
API リクエストが送信されるコンテンツ所有者の ID。リクエストでこのパラメータの値が指定されていない場合、API サーバーは、リクエストがユーザー自身のチャンネルに対して行われているものと見なします。 |
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンス
成功した場合、レスポンスの本文には Job リソースが含まれます。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-05-08 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-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"]]