php google people api

PHP Google People API

Этот пакет предоставляет удобный способ взаимодействия с контактами Google через API Google People.

Установка

PHP Google People API может быть легко установлен с помощью композитора. Просто запустите следующую команду из корня вашего проекта.

 composer require rapidwebltd/php-google-people-api

Если вы никогда не использовали менеджер по зависимости композитора, отправляйтесь на веб -сайт Composer для получения дополнительной информации о том, как начать.

Настраивать

Чтобы использовать этот пакет, вам необходимо аутентифицировать с Google через OAuth 2. К счастью, это легко сделано пакетом обработчика Google OAuth 2 Google.

Вы можете запустить его сценарий настройки с помощью следующей команды.

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

Это проведет вас через процесс настройки проекта и войти в учетную запись Google, для которой вы хотите управлять контактами. Когда его спросили, какие области вам требуются, введите следующее.

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

После завершения вам придется код, вам нужно создать объект GoogleOAuth2Handler для этой учетной записи Google.

Затем вы можете создать объект GooglePeople следующим образом.

 $ people = new GooglePeople ( $ googleOAuth2Handler );

Использование

Получить все контакты

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

Получить один контакт

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

Создать новый контакт

 // 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 ();

Обновите контакт

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

Удалить контакт

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