php google contacts v3 api

PHP Google Contacts V3 API

Biblioteca PHP para a API de contatos do Google (V3)

NOTA: Se você estiver iniciando um novo projeto, recomendamos fortemente o uso de nosso pacote de API do PHP Google People. É mais capaz que este pacote e usa uma API mais recente que provavelmente será suportada por mais tempo.

Instalação e dependências

Este pacote e suas dependências podem ser instalados usando composer .

Basta executar composer require rapidwebltd/php-google-contacts-v3-api .

Configurar

1. Instalar dependências necessárias. Veja a seção 'Dependências' acima.
2. Copie ou renomeie .config_blank.json para .config.json . Observe o ponto ( . ) No início do nome do arquivo.
3. Preencha o clientID , clientSecret e redirectUri em .config.json .

• Observe que o redirectUri deve ser configurado para apontar para o arquivo redirect-handler.php .
• O clientID e clientSecret podem ser encontrados no console do Google Developers em https://console.developers.google.com/ sob 'APIS & Auth' -> 'Credenciais', depois de ativar a API de contatos.

4. Vá para authorise-application.php em um navegador da web. Isso deve fornecer a você um URL para autorizar seu aplicativo para contatos do Google.
5. Vá para o URL de autorização fornecido pela etapa anterior.
6. Aceite as permissões solicitadas na página exibida. Você deve ser redirecionado de volta para o arquivo redirect-handler.php .
7. A página gerada pelo arquivo redirect-handler.php deve apresentar um token de atualização. Copie isso no seu .config.json .
8. A configuração está pronta!

Uso

Após a instalação da biblioteca e as etapas de configuração e associação de contas foram concluídas, você pode usar a biblioteca.

Se a sua estrutura não fizer isso por você, lembre -se de incluir o arquivo do vendor/autoload.php em todas as páginas que você deseja usar essa biblioteca.

Recuperando contatos do Google

O código a seguir recuperará todos os contatos da conta do Google associada.

 $ contacts = rapidweb  googlecontacts  factories ContactFactory:: getAll ();

var_dump ( $ contacts );

O método ContactFactory::getAll() retornará uma variedade de objetos Contact . Os detalhes do contato estarão disponíveis como variáveis ​​de membros públicos desses objetos.

O selfURL contido em cada objeto Contact é a referência exclusiva a esse contato específico. Se você precisar recuperar um contato específico no futuro, precisará armazenar esse selfURL .

Para recuperar um contato específico (por seu autourl), use o código a seguir.

 $ selfURL = " ... " ;

$ contact = rapidweb  googlecontacts  factories ContactFactory:: getBySelfURL ( $ selfURL );

var_dump ( $ contact );

Este método ContactFactory::getBySelfURL retornará um único objeto Contact .

As propriedades de contato do Google são acessadas da seguinte forma.

 $ selfURL = " ... " ;

$ contact = rapidweb  googlecontacts  factories ContactFactory:: getBySelfURL ( $ selfURL );

echo $ contact -> name ;
echo $ contact -> phoneNumber ;
echo $ contact -> email ;
echo $ contact -> content ;

Atualizando os contatos do Google existentes

A atualização dos contatos do Google usando esta biblioteca é feita de maneira muito orientada para objetos.

Você deve primeiro recuperar um objeto Contact usando um dos métodos mencionados anteriormente. Em seguida, você pode modificar as variáveis ​​de membros do objeto de contato. Para salvar essas alterações de volta ao Serviço de Contatos do Google, você passa o objeto modificado para o método ContactFactory::submitUpdates($contact) .

O código a seguir demonstra na recuperação total de um contato, modificando -o e enviando as atualizações.

 $ selfURL = " ... " ;

$ contact = rapidweb  googlecontacts  factories ContactFactory:: getBySelfURL ( $ selfURL );

var_dump ( $ contact );

$ contact -> name = ' Test ' ;
$ contact -> phoneNumber = ' 07812363789 ' ;
$ contact -> email = ' [email protected] ' ;
$ contact -> content = ' Note for example ' ;

$ contactAfterUpdate = rapidweb  googlecontacts  factories ContactFactory:: submitUpdates ( $ contact );

var_dump ( $ contactAfterUpdate );

Criando novos contatos do Google

Criar um novo contato do Google é muito fácil. Simplesmente ligue para o método ContactFactory::create($name, $phoneNumber, $emailAddress) , passando pelos parâmetros apropriados. Este método retornará o contato criado como um objeto Contact , incluindo seu recém -designado selfURL .

 $ name = " Frodo Baggins " ;
$ phoneNumber = " 06439111222 " ;
$ emailAddress = " [email protected] " ;
$ note = " Note for example " ;

$ newContact = rapidweb  googlecontacts  factories ContactFactory:: create ( $ name , $ phoneNumber , $ emailAddress , $ note );

Substituição de arquivo de configuração

Cada método possui argumento opcional para substituição de arquivo de configuração. É útil quando você deseja usar o trabalho com várias contas do Google ao mesmo tempo.

 $ customConfig = ( object ) array (
    ' clientID ' => ' <clientId which you get according to setup above> ' ,
    ' clientSecret ' => ' <clientSecret which you get according to setup above> ' ,
    ' redirectUri ' => ' <your redirect uri> ' ,
    ' developerKey ' => ' <developer key> ' ,
    ' refreshToken ' => ' <refresh token specific for google account> '
);

$ contacts = ContactFactory:: getAll ( $ customConfig );

Você deve definir todas as variáveis, pois a configuração original é completamente ignorada. Para ser mais preciso, não precisa existir.

Exemplos

Dê uma olhada nos seguintes arquivos para obter exemplos básicos de como recuperar contatos. Eles também podem ser usados ​​para garantir que você tenha associado atualmente sua conta do Google à biblioteca.

• test.php
• test_individual.php