Base de Conhecimento

A TeamViewer fornece uma API baseada na web que permite acessar dados e controlar vários aspectos de sua conta TeamViewer. Você pode usar a API para desenvolver aplicativos que integram a funcionalidade TeamViewer em seu próprio ambiente corporativo ou pode desenvolver aplicativos que todos podem usar.

Introdução

Imagine que você precise remover um grupo com dispositivos dentro, um por um e, em seguida, excluir um grupo. Tudo bem quando você tem alguns dispositivos, mas quando você tem centenas deles, isso pode ser um incômodo. Vamos aproveitar as vantagens da tecnologia da API, criando um script que excluirá um grupo para você automaticamente, incluindo dispositivos nele incluídos. Tudo que você precisa fazer é fornecer o token da API e o nome do grupo. Este artigo mostrará como fazer isso.

De uma perspectiva detalhada, usaremos as funções de API de Gerenciamento de Grupo e de Gerenciamento de Dispositivos. O Windows PowerShell foi usado para implementar a solução. Usando um token de usuário, o código irá recuperar os dispositivos e grupos de seu console de gerenciamento, exibi-los e permitir que você escolha o grupo que deseja excluir. Depois de fazer a seleção, o resultado será um belo console.

Primeiros passos

Certifique-se de ter uma conta TeamViewer. Se você não tiver uma conta, pode obter uma gratuitamente em http://login.teamviewer.com

Para criar um script, faça login no Management Console com sua conta TeamViewer e crie um token de script.

No console, abra as configurações do seu perfil no canto superior direito do site → Editar Perfil. Em seguida, selecione a guia Aplicativos e clique em Criar o token do script. Preencha o formulário para definir seu token

1. Digite o nome do seu script
2. Insira uma descrição para o seu token de script
3. Escolha as permissões do seu token de script
4. Gerenciamento de grupo - Visualize, crie, exclua, edite e compartilhe grupos
5. Computadores e contatos - Veja, adicione, edite e exclua entradas
6. Salve o token de script

Agora, salve o token em um local seguro. Ele será solicitado pelo script quando estiver em execução.

O Código

$token = Read-Host -Prompt "Paste your account token code here"
$bearer = "Bearer",$token

$header = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
$header.Add("authorization", $bearer)

$webrequest = Invoke-RestMethod -Uri "https://webapi.teamviewer.com/api/v1/groups/" -Method Get -Headers $header
$machine = Invoke-RestMethod -Uri "Https://webapi.teamviewer.com/api/v1/devices/" -Method Get -Headers $header

$i=1
$grpArr = @()

ForEach($grp in $webrequest.groups)
{
    Write-Host $i ")" $grp.name " - " $grp.id
    $grpArr += $grp.id;
    ForEach($dev in $machine.devices)
    {
        If($dev.groupid -eq  $grp.id)
        {
            Write-Host "     " $dev.alias
        }
    } 
    $i += 1
}
$ig = Read-Host -Prompt "Select the group you will like to remove"

ForEach ($dgrp in $machine.devices)
{
    if($dgrp.groupid -eq $grpArr[$ig - 1])
    {
        Write-Host "Delete device: " $dgrp.alias
        $item = $dgrp.device_id
        $delete = Invoke-WebRequest -Uri "Https://webapi.teamviewer.com/api/v1/devices/$item" -Method Delete -Headers $header
    }

}
Write-Host "Delete group id: " $grpArr[$ig - 1] 
   $gid = $grpArr[$ig - 1]
   $remove = Invoke-WebRequest -Uri "Https://webapi.teamviewer.com/api/v1/groups/$gid" -Method Delete -Headers $header 

Executando o Script

Copie o código do script em seu editor de texto favorito (por exemplo, Bloco de notas) e salve como arquivo .ps1. (test.ps1)

Vídeo

Assista ao vídeo a seguir para obter informações detalhadas sobre como o script funciona.

O Ponto de Partida

A API do TeamViewer é uma ferramenta valiosa quando você precisa obter o máximo do Management Console. Combinando isso com uma linguagem de programação e sua imaginação, você pode obter resultados instantâneos como este para suas tarefas diárias. Aproveite!