Conectando o YouTube
Conecte sua conta do YouTube ao Opus Growth.
Antes de começar
- O canal deve pertencer à conta Google com a qual você autoriza, ou essa conta deve ser adicionada como gerente do canal.
- Se o canal estiver em uma Conta de Marca, escolha essa conta de marca durante a autorização, e não a pessoal.
- A conexão é somente leitura; ela não altera nenhum vídeo, título ou descrição.
Etapas da conexão
- Execute a ferramenta. Diga ao seu assistente
connect_youtube. Ele retorna um link de autorização de uso único vinculado à sua conta; nada está conectado ainda nesta etapa. - Abra o link. O link é válido por uma hora. Abra-o em um navegador no qual você esteja conectado como a pessoa que tem acesso à conta do YouTube.
- Conceda o acesso. Aprove as permissões solicitadas na tela do YouTube. Essa é a tela de consentimento do próprio YouTube, então o login acontece lá, não conosco.
- Selecione uma conta. Suas contas são listadas após a autorização. Marque as que você quer gerenciar e salve; todas as operações seguintes são executadas na conta que você escolheu.
- Confirme. Execute
youtube_channels; se seu canal aparecer na lista, a conexão está pronta.
Permissões solicitadas
openidhttps://www.googleapis.com/auth/userinfo.emailhttps://www.googleapis.com/auth/yt-analytics.readonlyhttps://www.googleapis.com/auth/youtube.readonly
Nada além desta lista é solicitado, e o token é armazenado criptografado. Se você recusar qualquer permissão na tela de consentimento, o fluxo é interrompido e nenhum token é gravado.
Observações
- Uma conexão separada e somente leitura; seu token do Google Ads não é afetado.
- Seus canais são listados com
youtube_channels. - Ele lê relatórios de visualizações, tempo de exibição, inscritos e fontes de tráfego; não altera nenhum conteúdo.
Solução de problemas
Por que meu canal não aparece na lista?
Isso quase sempre acontece por autorizar com a conta errada. Se o canal estiver em uma Conta de Marca, você precisa escolher a conta de marca, e não a pessoal, na tela de consentimento do Google. Desconecte pelo painel e tente de novo com a conta certa.
Por que os números não batem exatamente com o YouTube Studio?
O YouTube Analytics corrige algumas métricas retroativamente e filtra visualizações que considera spam, e essas correções levam alguns dias. Ao consultar o mesmo período alguns dias depois, os números se estabilizam.
Por que o link diz que a conexão é inválida ou expirou?
Um link de autorização expira uma hora após ser gerado e só pode ser usado uma vez; abrir um link que já foi usado gera o mesmo erro. Execute a ferramenta de conexão novamente e você receberá um novo link para continuar.
Selecionei várias contas, mas só uma foi salva. Por quê?
Os planos Grátis e Pro conectam uma conta de anúncios por plataforma; gerenciar várias é um recurso do plano Agência. Mesmo que você marque mais de uma na tela de seleção, apenas a primeira é mantida ao salvar. Para trabalhar como agência, é preciso fazer upgrade do plano; depois disso, você atualiza a seleção pelo seletor de contas do painel, que reutiliza o token armazenado, então você nunca precisa autorizar de novo.
Autorizei com o usuário errado. O que acontece?
O acesso armazenado se limita às contas que o usuário autorizador consegue ver; uma conta que esse usuário não alcança também não fica visível para nós. Desconecte pelo painel e conecte novamente com o usuário correto, e o token antigo será excluído.
Desconexão
Abra o painel, encontre o YouTube em plataformas conectadas e escolha desconectar.
O token armazenado é excluído imediatamente, não apenas ocultado, então não conseguimos mais acessar a conta.
Reconectar depois significa executar connect_youtube novamente e passar pela
autorização do zero. Desconectar não exclui nada dentro da sua
conta do YouTube.