Google連絡先APIのPHPライブラリ(V3)
注:新しいプロジェクトを開始している場合は、代わりにPHP Google People APIパッケージを使用することを強くお勧めします。このパッケージよりも能力があり、おそらくより長くサポートされる新しいAPIを使用します。
このパッケージとその依存関係は、 composerを使用してインストールできます。
実行するcomposer require rapidwebltd/php-google-contacts-v3-api 。
.config_blank.jsonを.config.jsonにコピーまたは名前変更します。ファイル名の先頭にあるドット( . )に注意してください。.config.jsonのclientID 、 clientSecret 、およびredirectUriに記入してください。redirectUri redirect-handler.phpファイルを指すように構成する必要があることに注意してください。clientIDとclientSecret 、連絡先APIを有効にした後、「APIS&AUTH」 - > 'Credentials'の下で、https://console.developers.google.com/のGoogle開発者コンソールにあります。authorise-application.phpにアクセスしてください。これにより、Googleの連絡先のアプリケーションを承認するためのURLが提供されるはずです。redirect-handler.phpファイルにリダイレクトされる必要があります。redirect-handler.phpファイルによって生成されたページは、更新トークンを提示する必要があります。これを.config.jsonにコピーします。ライブラリがインストールされ、セットアップおよびアカウント関連の手順が完了した後、ライブラリを利用できます。
フレームワークがこれを実行しない場合は、このライブラリを使用するページにvendor/autoload.phpファイルを要求することを忘れないでください。
次のコードは、関連するGoogleアカウントからすべての連絡先を取得します。
$ contacts = rapidweb googlecontacts factories ContactFactory:: getAll ();
var_dump ( $ contacts ); ContactFactory::getAll()メソッドは、 Contact先オブジェクトの配列を返します。連絡先の詳細は、これらのオブジェクトのパブリックメンバー変数として利用できます。
各Contact先オブジェクトに含まれるselfURLこの特定の連絡先への一意の参照です。将来特定の連絡先を取得する必要がある場合は、このselfURLを保存する必要があります。
特定の連絡先を取得するには、(RECHURLで)、次のコードを使用します。
$ selfURL = " ... " ;
$ contact = rapidweb googlecontacts factories ContactFactory:: getBySelfURL ( $ selfURL );
var_dump ( $ contact );このContactFactory::getBySelfURLメソッドは、単一のContactオブジェクトを返します。
Googleの連絡先プロパティは、次のようにアクセスされます。
$ selfURL = " ... " ;
$ contact = rapidweb googlecontacts factories ContactFactory:: getBySelfURL ( $ selfURL );
echo $ contact -> name ;
echo $ contact -> phoneNumber ;
echo $ contact -> email ;
echo $ contact -> content ;このライブラリを使用したGoogle連絡先の更新は、非常にオブジェクト指向の方法で行われます。
前述の方法のいずれかを使用して、最初にContactオブジェクトを取得する必要があります。その後、連絡先オブジェクトのパブリックメンバー変数を変更できます。これらの変更をGoogle連絡先サービスに保存するには、変更されたオブジェクトをContactFactory::submitUpdates($contact)メソッドに渡します。
次のコードは、連絡先を完全に取得し、それを変更し、更新を送信することを示しています。
$ 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 );新しいGoogle連絡先を作成するのは非常に簡単です。 ContactFactory::create($name, $phoneNumber, $emailAddress)メソッドを呼び出し、適切なパラメーターを通過します。このメソッドは、新しく割り当てられたselfURLを含むContactオブジェクトとして作成された連絡先を返します。
$ name = " Frodo Baggins " ;
$ phoneNumber = " 06439111222 " ;
$ emailAddress = " [email protected] " ;
$ note = " Note for example " ;
$ newContact = rapidweb googlecontacts factories ContactFactory:: create ( $ name , $ phoneNumber , $ emailAddress , $ note );各メソッドには、構成ファイルオーバーライドのオプションの引数があります。複数のGoogleアカウントを同時に使用する場合に役立ちます。
$ 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 );元の構成が完全に無視されているため、すべての変数を定義する必要があります。より正確には、まったく存在する必要はありません。
連絡先を取得する方法の基本的な例については、次のファイルをご覧ください。また、現在、Googleアカウントをライブラリに関連付けていることを確認するためにも使用できます。