Estamos atualizando as APIs Reporting e YouTube Analytics para que elas correspondam à forma como o YouTube conta as visualizações dos Shorts.
Saiba mais
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 2024-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 2024-08-21 UTC."],[[["A `reportType` resource in the YouTube API defines a specific report that can be retrieved by a channel or content owner."],["The API supports listing available report types via the `reportTypes.list` method, enabling users to identify the reports they can access."],["Each `reportType` resource is represented in JSON and includes properties such as `id`, `name`, `deprecateTime`, and `systemManaged`, detailing the report's identifier, name, deprecation status, and whether it is system-managed."],["The `id` property of a report type can help identify the most recent version of the report, and there are different reports for channels, content owners and system managed."],["The `systemManaged` property indicates whether a report is automatically generated by YouTube for content owners, or if they need to use the jobs.create method to initiate report generation."]]],["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"]]