Method jobs.get
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Recupera informações sobre um job de geração de relatórios específico que foi programado para um canal ou proprietário de conteúdo.
Solicitação
Solicitação HTTP
GET https://youtubereporting.googleapis.com/v1/jobs/{jobId}
Autorização
Todas as solicitações da API Analytics Reporting precisam ser autorizadas. O guia de autorização explica como usar o protocolo OAuth 2.0 para recuperar tokens de autorização.
As solicitações da API Analytics Reporting do YouTube usam os seguintes escopos de autorização:
| Escopos |
| https://www.googleapis.com/auth/yt-analytics.readonly |
Visualizar os relatórios do YouTube Analytics para seu conteúdo do YouTube. Este escopo fornece acesso às métricas de atividade do usuário, como contagens de visualização e de classificação. |
| https://www.googleapis.com/auth/yt-analytics-monetary.readonly |
Visualizar os relatórios monetários do YouTube Analytics para seu conteúdo do YouTube. Esse escopo dá acesso às métricas de atividade do usuário e às métricas de receita estimada e performance do anúncio. |
Parâmetros
Parâmetros de caminho
| Parâmetros |
jobId |
string
Esse é o ID que o YouTube usa para identificar de forma exclusiva o job que está sendo recuperado. |
Parâmetros de consulta
| Parâmetros |
onBehalfOfContentOwner |
string
O ID do proprietário do conteúdo para quem a solicitação de API está sendo feita. Se a solicitação não especificar um valor para esse parâmetro, o servidor da API vai presumir que a solicitação está sendo feita para o próprio canal do usuário. |
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Resposta
Se a solicitação for bem-sucedida, o corpo da resposta conterá um recurso Job.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-09-18 UTC.
[null,null,["Última atualização 2025-09-18 UTC."],[],["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"]]
