php google people api

API do PHP Google People

Este pacote fornece uma maneira amigável de interagir com os contatos do Google através da API do Google People.

Instalação

A API do PHP Google People pode ser facilmente instalada usando o Composer. Basta executar o seguinte comando da raiz do seu projeto.

 composer require rapidwebltd/php-google-people-api

Se você nunca usou o Composer Dependence Manager antes, acesse o site do Composer para obter mais informações sobre como começar.

Configurar

Para usar este pacote, você precisa autenticar com o Google via Oauth 2. Felizmente, isso é facilitado pelo pacote PHP Google Oauth 2 Handler.

Você pode executar o script de configuração guiado com o seguinte comando.

 php vendor/rapidwebltd/php-google-oauth-2-handler/src/setup.php

Isso o guiará através do processo de configuração de um projeto e efetuará login na conta do Google para a qual você deseja gerenciar contatos. Quando perguntado a quais escopos você precisa de acesso, insira o seguinte.

 https://www.googleapis.com/auth/userinfo.profile
https://www.googleapis.com/auth/contacts
https://www.googleapis.com/auth/contacts.readonly

Quando concluído, você precisará codificar que você precisa criar um objeto GoogleOAuth2Handler para esta conta do Google.

Você pode criar um objeto GooglePeople , como segue.

 $ people = new GooglePeople ( $ googleOAuth2Handler );

Uso

Recuperar todos os contatos

 // Retrieval all contacts
foreach ( $ people -> all () as $ contact ) {
    echo $ contact -> resourceName . ' - ' ;
    if ( $ contact -> names ) {
        echo $ contact -> names [ 0 ]-> displayName ;
    }
    echo PHP_EOL ;
}

Recuperar um único contato

 // Retrieve single contact (by resource name)
$ contact = $ people -> get ( ' people/c8055020007701654287 ' );

Crie um novo contato

 // Create new contact
$ contact = new Contact ( $ people );
$ contact -> names [ 0 ] = new stdClass ;
$ contact -> names [ 0 ]-> givenName = ' Testy ' ;
$ contact -> names [ 0 ]-> familyName = ' McTest Test ' ;
$ contact -> save ();

Atualize um contato

 // Update contact
$ contact -> names [ 0 ]-> familyName = ' McTest ' ;
$ contact -> save ();

Exclua um contato

 // Delete contact
$ contact -> delete ();