Google 연락처 API (V3) 용 PHP 라이브러리
참고 : 새로운 프로젝트를 시작하는 경우 대신 PHP Google People API 패키지를 사용하는 것이 좋습니다. 이 패키지보다 더 능력이 있으며 더 오래 지원되는 최신 API를 사용합니다.
이 패키지와 그 종속성은 composer 사용하여 설치할 수 있습니다.
composer require rapidwebltd/php-google-contacts-v3-api .
.config.json 으로 .config_blank.json 복사하거나 바꾸십시오. 파일 이름의 시작 부분에서 점 ( . )에 주목하십시오..config.json 에서 clientID , clientSecret 및 redirectUri 작성하십시오.redirectUri 는 redirect-handler.php 파일을 가리 키도록 구성해야합니다.clientID 및 clientSecret 연락처 API를 활성화 한 후 'APIS & AUT' -> '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 을 저장해야합니다.
특정 연락처를 검색하려면 (자연으로) 다음 코드를 사용하십시오.
$ 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 계정을 라이브러리와 연결했는지 확인하는 데 사용될 수도 있습니다.