php google people api

PHP Google People API

Dieses Paket bietet eine benutzerfreundliche Möglichkeit, mit Google -Kontakten über die Google People -API zu interagieren.

Installation

PHP Google People API kann einfach mit Composer installiert werden. Führen Sie einfach den folgenden Befehl aus der Wurzel Ihres Projekts aus.

 composer require rapidwebltd/php-google-people-api

Wenn Sie den Komponisten -Abhängigkeitsmanager noch nie verwendet haben, besuchen Sie die Komponist -Website, um weitere Informationen zum Einstieg zu erhalten.

Aufstellen

Um dieses Paket zu verwenden, müssen Sie sich mit Google über OAUTH 2 authentifizieren. Zum Glück wird dies durch das PHP Google OAuth 2 Handler -Paket erleichtert.

Sie können das geführte Setup -Skript mit dem folgenden Befehl ausführen.

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

Dies führt Sie durch den Prozess der Einrichtung eines Projekts und der Anmeldung an das Google -Konto, für das Sie Kontakte verwalten möchten. Auf die Frage, auf welche Bereiche Sie zugreifen müssen, geben Sie Folgendes ein.

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

Wenn Sie fertig sind, müssen Sie für dieses Google -Konto ein GoogleOAuth2Handler -Objekt erstellen.

Sie können dann wie folgt ein GooglePeople -Objekt erstellen.

 $ people = new GooglePeople ( $ googleOAuth2Handler );

Verwendung

Alle Kontakte abrufen

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

Einen einzigen Kontakt abrufen

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

Erstellen Sie einen neuen Kontakt

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

Aktualisieren Sie einen Kontakt

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

Einen Kontakt löschen

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