ReportTypes
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O recurso reportType identifica um relatório específico que um canal ou proprietário de conteúdo pode recuperar.
Métodos
A tabela a seguir mostra os métodos compatíveis com a API para recursos report.
| Métodos |
list |
Retorna uma lista de tipos de relatório que o canal ou o proprietário do conteúdo pode recuperar. |
Representação de recurso JSON
A estrutura JSON abaixo mostra o formato de um recurso reportType:
{
"id": string,
"name": string,
"deprecateTime": timestamp,
"systemManaged": boolean
}
Propriedades
A tabela a seguir define as propriedades que aparecem neste recurso:
| Propriedades |
id |
string e
O ID que o YouTube usa para identificar o relatório de forma exclusiva. O valor da propriedade deve ter no máximo 100 caracteres. A tabela abaixo identifica a versão mais recente de cada tipo de relatório compatível (máximo de 100 caracteres).
Consulte os relatórios de canais compatíveis
| Relatórios |
| channel_basic_a2 |
Atividade do usuário |
| channel_province_a2 |
Atividade do usuário por província |
| channel_playback_location_a2 |
Locais de reprodução |
| channel_traffic_source_a2 |
Origens de tráfego |
| channel_device_os_a2 |
Dispositivo e sistema operacional |
| channel_demographics_a1 |
Informações demográficas |
| channel_sharing_service_a1 |
Serviços de compartilhamento |
| channel_annotations_a1 |
Anotações |
| channel_cards_a1 |
Cards |
| channel_end_screens_a1 |
Telas finais |
| channel_subtitles_a2 |
Legendas |
| channel_combined_a2 |
Combinado |
| audience_retention_a1 |
Retenção de público dos vídeos |
| playlist_basic_a1 |
Atividade do usuário da playlist |
| playlist_province_a1 |
Atividade do usuário da playlist por província |
| playlist_playback_location_a1 |
Locais de reprodução da playlist |
| playlist_traffic_source_a1 |
Origens de tráfego da playlist |
| playlist_device_os_a1 |
Dispositivo e sistema operacional da playlist |
| playlist_combined_a1 |
Playlist combinada |
.
Consulte os relatórios compatíveis com proprietários do conteúdo
| Relatórios |
| content_owner_basic_a3 |
Atividade do usuário |
| content_owner_province_a2 |
Atividade do usuário por província |
| content_owner_playback_location_a2 |
Locais de reprodução |
| content_owner_traffic_source_a2 |
Origens de tráfego |
| content_owner_device_os_a2 |
Dispositivo e sistema operacional |
| content_owner_demographics_a1 |
Informações demográficas |
| content_owner_sharing_service_a1 |
Serviços de compartilhamento |
| content_owner_annotations_a1 |
Anotações |
| content_owner_cards_a1 |
Cards |
| content_owner_end_screens_a1 |
Telas finais |
| content_owner_subtitles_a2 |
Legendas |
| content_owner_combined_a2 |
Combinado |
| content_owner_playlist_basic_a1 |
Atividade do usuário da playlist |
| content_owner_playlist_province_a1 |
Atividade do usuário da playlist por província |
| content_owner_playlist_playback_location_a1 |
Locais de reprodução da playlist |
| content_owner_playlist_traffic_source_a1 |
Origens de tráfego da playlist |
| content_owner_playlist_device_os_a1 |
Dispositivo e sistema operacional da playlist |
| content_owner_playlist_combined_a1 |
Playlist combinada |
| content_owner_ad_rates_a1 |
Desempenho do anúncio |
| content_owner_estimated_revenue_a1 |
Receita estimada por vídeo |
| content_owner_asset_estimated_revenue_a1 |
Receita estimada por recurso |
| content_owner_asset_basic_a2 |
Atividade do usuário para recursos |
| content_owner_asset_province_a2 |
Atividade do usuário por província para recursos |
| content_owner_asset_playback_location_a2 |
Locais de reprodução do recurso |
| content_owner_asset_traffic_source_a2 |
Origens de tráfego dos recursos |
| content_owner_asset_device_os_a2 |
Dispositivo e sistema operacional do recurso |
| content_owner_asset_demographics_a1 |
Informações demográficas do recurso |
| content_owner_asset_sharing_service_a1 |
Serviços de compartilhamento de recursos |
| content_owner_asset_annotations_a1 |
Anotações do recurso |
| content_owner_asset_cards_a1 |
Cards de recursos |
| content_owner_asset_end_screens_a1 |
Telas finais de recursos |
| content_owner_asset_combined_a2 |
Recurso combinado |
.
Consulte os relatórios gerenciados pelo sistema compatíveis (para proprietários do conteúdo)
| Relatórios gerenciados pelo sistema |
content_owner_ad_revenue_raw_a1 |
Receita de publicidade granular por vídeo |
content_owner_ad_revenue_summary_a1 |
Receita agregada de anúncios por vídeo |
content_owner_asset_ad_revenue_raw_a1 |
Receita de publicidade granular por recurso |
content_owner_asset_ad_revenue_summary_a1 |
Receita agregada de anúncios por recurso |
content_owner_claim_ad_revenue_summary_a1 |
Reivindicações (este relatório não contém dados de receita) |
|
name |
string e
O nome do relatório. O valor da propriedade deve ter no máximo 100 caracteres. |
deprecateTime |
timestamp e
A data e a hora em que o uso do relatório foi ou será suspenso. Se você tiver um job para um tipo de relatório descontinuado, o YouTube vai gerar novos relatórios para ele por três meses após o anúncio da data de descontinuação.
Por exemplo, o aviso de descontinuação do relatório content_owner_basic_a1 foi em 19 de maio de 2016. Por isso, o campo deprecateTime desse tipo de relatório especifica o dia 19 de agosto de 2016. Após essa data, o YouTube deixará de gerar relatórios desse tipo. |
systemManaged |
boolean e
Esse valor será true se o YouTube gerar automaticamente o relatório para proprietários de conteúdo do YouTube sem que os proprietários de conteúdo precisem chamar primeiro o método jobs.create para instruir o YouTube a gerar o relatório. Na verdade, o método jobs.create retornará um erro se a propriedade reportTypeId identificar um relatório gerenciado pelo sistema. |
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-08-21 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-21 UTC."],[],["A `reportType` resource defines a retrievable report for channels or content owners. The API supports listing available `reportTypes`. Each `reportType` has an `id`, `name`, `deprecateTime`, and `systemManaged` status. The `id` property identifies the report's type, such as user activity or demographics. `SystemManaged` reports are generated automatically, whereas other reports have to be called using the `jobs.create` method. The deprecation date marks when report generation stops.\n"]]