google-api-php-client - GitLite

KO | EN

gitlite — search

#javascript #react #ai #typescript #llm #go #rust #deep-learning #linux #docker #macos #cli #awesome-list #openai

google-api-php-client

(★ 9,804)

Google API에 엑세스하기 위한 PHP 클라이언트 라이브러리

파일 탐색기

최종 버전 다운로드 (.zip)

- - bug_report.md
  - feature_request.md
  - support_request.md
- - asset-release.yml
  - docs.yml
  - tests.yml
- CODEOWNERS
- CONTRIBUTING.md
- conventional-commit-lint.yaml
- release-please.yml
- release-trigger.yml
- sync-repo-settings.yaml
- api-keys.md
- auth.md
- id-token.md
- install.md
- media.md
- oauth-server.md
- oauth-web.md
- pagination.md
- parameters.md
- README.md
- start.md
- - style.css
- - base.php
- batch.php
- idtoken.php
- index.php
- large-file-download.php
- large-file-upload.php
- multi-api.php
- README.md
- service-account.php
- simple-file-upload.php
- simple-query.php
- - Revoke.php
  - Verify.php
- - AuthHandlerFactory.php
  - Guzzle6AuthHandler.php
  - Guzzle7AuthHandler.php
- - Batch.php
  - MediaFileUpload.php
  - REST.php
- - Exception.php
  - README.md
  - Resource.php
- - Composer.php
  - Exception.php
  - Retryable.php
  - Runner.php
- - UriTemplate.php
- aliases.php
- Client.php
- Collection.php
- Exception.php
- Model.php
- Service.php
- - test.ini
- - batchTest.php
  - idTokenTest.php
  - indexTest.php
  - largeFileDownloadTest.php
  - largeFileUploadTest.php
  - multiApiTest.php
  - serviceAccountTest.php
  - simpleFileUploadTest.php
  - simpleQueryTest.php
- - CacheTest.php
  - ClientTest.php
  - ModelTest.php
  - ServiceTest.php
- BaseTest.php
- bootstrap.php
- clearToken.php
- README
.gitattributes
.gitignore
CHANGELOG.md
CODE_OF_CONDUCT.md
composer.json
LICENSE
phpcs.xml.dist
phpstan.neon.dist
phpunit.xml.dist
README.md
SECURITY.md
UPGRADING.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/googleapis/google-api-php-client

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd google-api-php-client

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. PHP (Composer)

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
PHP PHP 실행 환경이 필요합니다.
Composer PHP 라이브러리 설치를 위한 패키지 매니저입니다.

composer require google/apiclient

이 명령어를 터미널에 그대로 입력해 실행하세요.

"pre-autoload-dump": "Google\\Task\\Composer::cleanup"

이 명령어를 터미널에 그대로 입력해 실행하세요.

composer update

이 명령어를 터미널에 그대로 입력해 실행하세요.

// include your composer dependencies

이 명령어를 터미널에 그대로 입력해 실행하세요.

composer require cache/filesystem-adapter

이 명령어를 터미널에 그대로 입력해 실행하세요.

✅ php -S localhost:8000 같은 내장 서버로 실행한 뒤 브라우저에서 http://localhost:8000 으로 접속해보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![](https://github.com/googleapis/google-api-php-client/workflows/.github/workflows/tests.yml/badge.svg)
# Google APIs Client Library for PHP #
\*\*참고\*\*: 권장 라이브러리인 [Google cloud packages](https://cloud.google.com/php/docs/reference) 목록에 설치하려는 패키지가 있는지 먼저 확인해 주세요.

참조 문서 (Reference Docs)
:   <https://googleapis.github.io/google-api-php-client/>

라이선스 (License)
:   Apache 2.0

Google API Client Library를 사용하면 서버에서 Gmail, Drive, YouTube 같은 Google API를 활용할 수 있습니다.
이 클라이언트 라이브러리는 Google에서 공식적으로 지원합니다. 하지만 이 라이브러리는 개발이 완료되어 유지보수 모드에 있습니다. 즉, 치명적인 버그와 보안 문제는 처리하지만 새로운 기능은 추가되지 않습니다.
## Google Cloud Platform
[Datastore][cloud-datastore], [Cloud Storage][cloud-storage], [Pub/Sub][cloud-pubsub], [Compute Engine][cloud-compute]과 같은 Google Cloud Platform API의 경우, Google Cloud 클라이언트 라이브러리를 사용하는 것을 권장합니다. 지원되는 Google Cloud 클라이언트 라이브러리의 전체 목록은 [googleapis/google-cloud-php](https://github.com/googleapis/google-cloud-php)에서 확인하세요.
[cloud-datastore]: https://github.com/googleapis/google-cloud-php-datastore
[cloud-pubsub]: https://github.com/googleapis/google-cloud-php-pubsub
[cloud-storage]: https://github.com/googleapis/google-cloud-php-storage
[cloud-compute]: https://github.com/googleapis/google-cloud-php-compute
## 요구 사항 (Requirements) ##
\* [PHP 8.0 이상](https://www.php.net/)
## 개발자 문서 (Developer Documentation) ##
[docs 폴더](docs/)에서 이 라이브러리 사용을 위한 상세한 가이드를 제공합니다.
## 설치 (Installation) ##
\*\*Composer\*\*를 사용하거나 단순히 \*\*릴리스 다운로드(Download the Release)\*\*를 할 수 있습니다.
### Composer
권장되는 방법은 [composer](https://getcomposer.org/)를 사용하는 것입니다. composer가 아직 설치되어 있지 않다면 [설치 지침](https://getcomposer.org/doc/00-intro.md)을 따르세요.
composer가 설치되면, 라이브러리를 설치하기 위해 프로젝트 루트에서 다음 명령어를 실행하세요:
```sh
composer require google/apiclient
```
타임아웃 오류가 발생하는 경우, `COMPOSER\_PROCESS\_TIMEOUT=600 composer install`과 같이 환경 변수 플래그를 추가하여 composer의 타임아웃을 늘리거나, composer 스키마의 `config` 섹션에 다음을 추가할 수 있습니다:
```
{
"config": {
"process-timeout": 600
}
}
```
마지막으로, 오토로더(autoloader)를 반드시 포함해야 합니다:
```php
require\_once '/path/to/your-project/vendor/autoload.php';
```
이 라이브러리는 `google/apiclient-services`에 의존합니다. 해당 라이브러리는 수많은 Google API에 대한 최신 API 래퍼를 제공합니다. 사용자가 최신 API 클라이언트를 사용할 수 있도록, 이 라이브러리는 `google/apiclient-services`의 특정 버전을 고정(pin)해 두지 않습니다. \*\*호환성이 깨지는 변경(breaking changes)이 포함된 API 래퍼가 실수로 설치되는 것을 방지하기 위해\*\*, 프로덕션 환경에서 이 라이브러리를 사용하기 전에 직접 [최신 버전](https://github.com/googleapis/google-api-php-client-services/releases)으로 버전을 고정하는 것을 강력히 권장합니다.
#### 사용하지 않는 서비스 정리하기
200개가 넘는 Google API 서비스가 존재합니다. 이 모든 서비스를 전부 사용하지 않을 가능성이 높습니다. 코드에 이러한 종속성이 포함되는 것을 방지하기 위해, `Google\Task\Composer::cleanup` 작업을 실행하고 `composer.json`에 유지할 서비스를 지정할 수 있습니다:
```json
{
"require": {
"google/apiclient": "^2.15.0"
},
"scripts": {
"pre-autoload-dump": "Google\\Task\\Composer::cleanup"
},
"extra": {
"google/apiclient-services": [
"Drive",
"YouTube"
]
}
}
```
이 예제는 `composer update` 또는 새로운 `composer-install`이 실행될 때 "Drive"와 "YouTube"를 제외한 모든 서비스를 제거합니다.
\*\*중요 (IMPORTANT)\*\*: `composer.json`에 서비스를 다시 추가하는 경우, 변경 사항이 적용되도록 `vendor/google/apiclient-services` 디렉토리를 명시적으로 삭제해야 합니다:
```sh
rm -r vendor/google/apiclient-services
composer update
```
\*\*참고 (NOTE)\*\*: 이 명령어는 서비스 이름과 정확히 일치하는지(exact match) 확인하므로, `YouTubeReporting`과 `YouTubeAnalytics`도 유지하려면 각각을 명시적으로 추가해야 합니다:
```json
{
"extra": {
"google/apiclient-services": [
"Drive",
"YouTube",
"YouTubeAnalytics",
"YouTubeReporting"
]
}
}
```
### 릴리스 다운로드 (Download the Release)
composer를 사용하지 않으려면 패키지 전체를 다운로드할 수 있습니다. [Releases](https://github.com/googleapis/google-api-php-client/releases) 페이지에는 모든 안정 버전이 나열되어 있습니다. 원하는 파일을 다운로드하세요.

이 라이브러리와 그 의존성 패키지가 포함된 `google-api-php-client-[RELEASE\_NAME].zip` 이름의 파일입니다.
다운로드한 zip 파일을 압축 해제하고, 프로젝트에 오토로더(autoloader)를 포함합니다:
```php
require\_once '/path/to/google-api-php-client/vendor/autoload.php';
```
추가적인 설치 및 설정 방법은 [문서(documentation)](docs/)를참고하세요.
## Examples ##
핵심 클라이언트 기능에 대한 예제는 [`examples/`](examples) 디렉터리를 확인하세요. PHP 내장 웹 서버를 실행하여 브라우저에서 확인할 수 있습니다.
```
$ php -S localhost:8000 -t examples/
```
그런 다음 지정한 호스트와 포트로 접속합니다
(위의 예제에서는 `http://localhost:8000`).
### Basic Example ###
```php
// include your composer dependencies
require\_once 'vendor/autoload.php';
$client = new Google\Client();
$client->setApplicationName("Client\_Library\_Examples");
$client->setDeveloperKey("YOUR\_APP\_KEY");
$service = new Google\Service\Books($client);
$query = 'Henry David Thoreau';
$optParams = [
'filter' => 'free-ebooks',
];
$results = $service->volumes->listVolumes($query, $optParams);
foreach ($results->getItems() as $item) {
echo $item['volumeInfo']['title'], "  
 \n";
}
```
### Authentication with OAuth ###
> 이에 대한 예제는 [`examples/simple-file-upload.php`](examples/simple-file-upload.php)에서 확인할 수 있습니다.
1. [웹 애플리케이션 자격 증명 만들기(Create Web Application Credentials)](docs/oauth-web.md#create-authorization-credentials) 안내를 따릅니다.
1. JSON 자격 증명을 다운로드합니다.
1. `Google\Client::setAuthConfig`를 사용하여 이 자격 증명의 경로를 설정합니다:
```php
$client = new Google\Client();
$client->setAuthConfig('/path/to/client\_credentials.json');
```
1. 호출하려는 API에 필요한 스코프(scope)를 설정합니다.
```php
$client->addScope(Google\Service\Drive::DRIVE);
```
1. 애플리케이션의 리다이렉트 URI를 설정합니다.
```php
// Your redirect URI can be any registered URI, but in this example
// we redirect back to this same page
$redirect\_uri = 'http://' . $\_SERVER['HTTP\_HOST'] . $\_SERVER['PHP\_SELF'];
$client->setRedirectUri($redirect\_uri);
```
1. 리다이렉트 URI를 처리하는 스크립트에서 인증 코드를 액세스 토큰으로 교환합니다:
```php
if (isset($\_GET['code'])) {
$token = $client->fetchAccessTokenWithAuthCode($\_GET['code']);
}
```
### Authentication with Service Accounts ###
> 이에 대한 예제는 [`examples/service-account.php`](examples/service-account.php)에서 확인할 수 있습니다.
일부 API
(예: [YouTube Data API](https://developers.google.com/youtube/v3/))는
서비스 계정을 지원하지 않습니다. API 호출 시 예상치 못한 401 또는 403 오류가 발생하는 경우 특정 API 문서를 확인하세요.
1. [서비스 계정 만들기(Create a Service Account)](docs/oauth-server.md#creating-a-service-account) 안내를 따릅니다.
1. JSON 자격 증명을 다운로드합니다.
1. `GOOGLE\_APPLICATION\_CREDENTIALS` 환경 변수를 사용하여 이 자격 증명의 경로를 설정합니다:
```php
putenv('GOOGLE\_APPLICATION\_CREDENTIALS=/path/to/service-account.json');
```
1. Google 클라이언트에 서비스 계정 자격 증명을 사용하여 인증하도록 지시합니다:
```php
$client = new Google\Client();
$client->useApplicationDefaultCredentials();
```
1. 호출하려는 API에 필요한 스코프를 설정합니다.
```php
$client->addScope(Google\Service\Drive::DRIVE);
```
1. 서비스 계정에 도메인 전체 권한을 위임했고 사용자 계정을 가장(impersonate)하려는 경우, setSubject 메서드를 사용하여 사용자 계정의 이메일 주소를 지정합니다:
```php
$client->setSubject($user\_to\_impersonate);
```
#### How to use a specific JSON key
`GOOGLE\_APPLICATION\_CREDENTIALS` 환경 변수를 사용하는 대신 특정 JSON 키를 사용하려면 다음과 같이 할 수 있습니다:
```php
$jsonKey = [
'type' => 'service\_account',
// ...
];
$client = new Google\Client();
$client->setAuthConfig($jsonKey);
```
### Making Requests ###
[google-api-php-client-services](https://github.com/googleapis/google-api-php-client-services)에서 API를 호출하는 데 사용되는 클래스들은 자동으로 생성됩니다. 이 클래스들은 JSON 요청 및 응답과 직접 매핑됩니다.

[APIs Explorer](https://developers.google.com/apis-explorer/#p/)에서 확인할 수 있습니다.
[Datastore API](https://developers.google.com/apis-explorer/#p/datastore/v1beta3/datastore.projects.runQuery)에 대한 JSON 요청은 다음과 같습니다:
```
POST https://datastore.googleapis.com/v1beta3/projects/YOUR\_PROJECT\_ID:runQuery?key=YOUR\_API\_KEY
```
```json
{
"query": {
"kind": [{
"name": "Book"
}],
"order": [{
"property": {
"name": "title"
},
"direction": "descending"
}],
"limit": 10
}
}
```
이 라이브러리를 사용하면 동일한 호출이 다음과 같아집니다:
```php
// create the datastore service class
$datastore = new Google\Service\Datastore($client);
// build the query - this maps directly to the JSON
$query = new Google\Service\Datastore\Query([
'kind' => [
[
'name' => 'Book',
],
],
'order' => [
'property' => [
'name' => 'title',
],
'direction' => 'descending',
],
'limit' => 10,
]);
// build the request and response
$request = new Google\Service\Datastore\RunQueryRequest(['query' => $query]);
$response = $datastore->projects->runQuery('YOUR\_DATASET\_ID', $request);
```
하지만 JSON API의 각 속성에 대응하는 생성된 클래스가 존재하므로, 위 코드는 다음과 같이 작성할 수도 있습니다:
```php
// create the datastore service class
$datastore = new Google\Service\Datastore($client);
// build the query
$request = new Google\Service\Datastore\_RunQueryRequest();
$query = new Google\Service\Datastore\Query();
// - set the order
$order = new Google\Service\Datastore\_PropertyOrder();
$order->setDirection('descending');
$property = new Google\Service\Datastore\PropertyReference();
$property->setName('title');
$order->setProperty($property);
$query->setOrder([$order]);
// - set the kinds
$kind = new Google\Service\Datastore\KindExpression();
$kind->setName('Book');
$query->setKinds([$kind]);
// - set the limit
$query->setLimit(10);
// add the query to the request and make the request
$request->setQuery($query);
$response = $datastore->projects->runQuery('YOUR\_DATASET\_ID', $request);
```
사용하는 방법은 취향에 따라 선택하면 되지만, \*API의 JSON 구문을 먼저 이해하지 않고 이 라이브러리를 사용하는 것은 매우 어렵습니다\*. 따라서 여기에 있는 서비스를 사용하기 전에 [APIs Explorer](https://developers.google.com/apis-explorer/#p/)를 살펴보는 것을 권장합니다.
### 직접 HTTP 요청하기 ###
외부 애플리케이션에 Google 인증이 필요하거나, 이 라이브러리에 아직 Google API가 구현되어 있지 않은 경우 HTTP 요청을 직접 수행할 수 있습니다.
오직 자신의 HTTP 클라이언트 요청을 인증하기 위해서만 이 클라이언트를 설치하는 경우, 대신 [`google/auth`](https://github.com/googleapis/google-auth-library-php#call-the-apis)를 사용해야 합니다.
`authorize` 메서드는 인증된 [Guzzle Client](http://docs.guzzlephp.org/)를 반환하므로, 해당 클라이언트를 사용하여 이루어지는 모든 요청에는 상응하는 인증이 포함됩니다.
```php
// create the Google client
$client = new Google\Client();
/\*\*
\* Set your method for authentication. Depending on the API, This could be
\* directly with an access token, API key, or (recommended) using
\* Application Default Credentials.
\*/
$client->useApplicationDefaultCredentials();
$client->addScope(Google\Service\Plus::PLUS\_ME);
// returns a Guzzle HTTP Client
$httpClient = $client->authorize();
// make an HTTP request
$response = $httpClient->get('https://www.googleapis.com/plus/v1/people/me');
```
### 캐싱 ###
성능을 향상시키기 위해 다른 캐싱 라이브러리를 사용하는 것을 권장합니다. [PSR-6](https://www.php-fig.org/psr/psr-6/) 호환 라이브러리를 클라이언트에 전달하여 수행할 수 있습니다:
```php
use League\Flysystem\Adapter\Local;
use League\Flysystem\Filesystem;
use Cache\Adapter\Filesystem\FilesystemCachePool;
$filesystemAdapter = new Local(\_\_DIR\_\_.'/');
$filesystem = new Filesystem($filesystemAdapter);
$cache = new FilesystemCachePool($filesystem);
$client->setCache($cache);
```
이 예제에서는 [PHP Cache](http://www.php-cache.com/)를 사용합니다. composer를 사용하여 프로젝트에 이를 추가하세요:
```

composer require cache/filesystem-adapter
```
### 토큰 업데이트 ###
[Refresh Tokens](https://developers.google.com/identity/protocols/OAuth2InstalledApp#offline) 또는 [Service Account Credentials](https://developers.google.com/identity/protocols/OAuth2ServiceAccount#overview)를 사용할 때,새로운 액세스 토큰이 부여되면 특정 작업을 수행하는 것이 유용할 수 있습니다. 이를 수행하려면 클라이언트의 `setTokenCallback` 메서드에 콜러블을 전달합니다:
```php
$logger = new Monolog\Logger();
$tokenCallback = function ($cacheKey, $accessToken) use ($logger) {
$logger->debug(sprintf('new access token received at cache key %s', $cacheKey));
};
$client->setTokenCallback($tokenCallback);
```
### Charles를 사용하여 HTTP 요청 디버깅하기 ###
원시 HTTP 요청을 확인하여 API 호출을 디버깅하는 것은 매우 유용합니다. 이 라이브러리는 [Charles Web Proxy](https://www.charlesproxy.com/documentation/getting-started/) 사용을 지원합니다. Charles를 다운로드하여 실행한 후, 다음 코드를 사용하여 Charles를 통해 모든 HTTP 트래픽을 캡처합니다:
```php
// 디버깅 전용
$httpClient = new GuzzleHttp\Client([
'proxy' => 'localhost:8888', // 기본적으로 Charles는 localhost 포트 8888에서 실행됩니다.
'verify' => false, // 그렇지 않으면 HTTPS 요청이 실패합니다.
]);
$client = new Google\Client();
$client->setHttpClient($httpClient);
```
이제 이 라이브러리가 수행하는 모든 호출이 Charles UI에 나타납니다.
SSL 요청을 보려면 Charles에서 추가 단계가 하나 필요합니다. \*\*Charles > Proxy > SSL Proxying Settings\*\*로 이동하여 캡처하려는 도메인을 추가합니다. Google API의 경우 일반적으로 `\*.googleapis.com`입니다.
### HTTP 클라이언트 구성 직접 제어하기
Google API Client는 기본 HTTP 클라이언트로 [Guzzle](http://docs.guzzlephp.org/)을 사용합니다. 즉, Guzzle을 사용하는 다른 애플리케이션과 동일한 방식으로 HTTP 요청을 제어할 수 있습니다.
예를 들어, 각 요청에 리퍼러(referrer)를 적용하고 싶다고 가정해 보겠습니다.
```php
use GuzzleHttp\Client;
$httpClient = new Client([
'headers' => [
'referer' => 'mysite.com'
]
]);
$client = new Google\Client();
$client->setHttpClient($httpClient);
```
[Handlers and Middleware](http://docs.guzzlephp.org/en/stable/handlers-and-middleware.html)와 같은 다른 Guzzle 기능은 훨씬 더 강력한 제어 기능을 제공합니다.
### 부분 동의 및 부여된 범위(Granted Scopes)
OAuth2 3LO를 사용할 때 (예: [간단한 파일 업로드 예제](examples/simple-file-upload.php)에서처럼 제3자로부터 자격 증명을 요청하는 클라이언트인 경우), 부분 동의(Partial Consent) 기능을 활용하고 싶을 수 있습니다.
클라이언트가 OAuth2 화면에서 특정 범위만 부여할 수 있도록 허용하려면, 권한 부여 URL을 생성할 때 `enable\_serial\_consent`에 대한 쿼리스트링 매개변수를 전달합니다:
```php
$authUrl = $client->createAuthUrl($scope, ['enable\_serial\_consent' => 'true']);
```
플로우가 완료되면 OAuth2 객체에서 `getGrantedScope`를 호출하여 부여된 범위를 확인할 수 있습니다:
```php
// 부여된 범위가 존재할 경우 공백으로 구분된 문자열, 그렇지 않으면 null.
echo $client->getOAuth2Service()->getGrantedScope();
```
### 서비스별 예제 ###
YouTube: https://github.com/youtube/api-samples/tree/master/php
## 기여는 어떻게 하나요? ##
자세한 내용은 [contributing](.github/CONTRIBUTING.md) 페이지를 참조하세요. 특히 풀 리퀘스트(pull request)를 환영하지만, 기여자 라이선스 계약(contributor license agreement)에 서명해 주시기 바랍니다.
## 자주 묻는 질문 ##
### 뭔가 작동하지 않을 때는 어떻게 해야 하나요? ###
라이브러리 지원과 관련하여 질문하기 가장 좋은 장소는 StackOverflow의 google-api-php-client 태그입니다: https://stackoverflow.com/questions/tagged/google-api-php-client
라이브러리에 특정 버그가 있는 경우, 실패한 코드의 예제와 수집된 특정 오류를 포함하여 GitHub 이슈 트래커에 [이슈를 제기](https://github.com/googleapis/google-api-php-client/issues)해 주세요. 기능 요청의 경우 코어 라이브러리 요청이고 API 종속적이 아닌 경우에 한해 등록할 수 있습니다. API별 기능에 대해서는 해당 개별 API의 문서를 참조하는 것이 가장 좋습니다.

파일 요청입니다. 해당 기능이 해결할 수 있는 문제에 대해 명확한 설명을 제공해 주세요.
### X의 예시를 원합니다! ###
X가 라이브러리의 기능이라면 언제든 제출해 주세요! X가 특정 서비스 사용 예시라면, 해당 특정 API를 담당하는 팀에 문의하는 것이 가장 좋습니다. 라이브러리에 직접 추가하는 것보다 해당 팀의 예시 링크를 제공하는 것을 선호하는데, 이를 통해 라이브러리의 특정 버전에 고정할 수 있기 때문입니다. 다른 API에 대한 예시가 있다면 알려주세요. 위의 README에 기꺼이 링크를 추가하겠습니다!
### 왜 일부 Google\Service 클래스는 이상한 이름을 가지고 있나요? ###
_Google\Service_ 클래스는 일반적으로 API 검색 문서( https://developers.google.com/discovery/ )를 기반으로 자동 생성됩니다. 때로는 특이한 이름을 가진 새로운 기능이 API에 추가되기도 하며, 이로 인해 PHP 클래스에서 예상치 못하거나 표준이 아닌 스타일의 이름이 지정될 수 있습니다.
### JSON이 아닌 응답 유형은 어떻게 처리하나요? ###
일부 서비스는 라이브러리가 지원하는 JSON 대신 기본적으로 XML 또는 유사한 형식을 반환합니다. 일반적으로 메서드 호출의 마지막 인자인 선택적 매개변수에 'alt' 인수를 추가하여 JSON 응답을 요청할 수 있습니다:
```php
$opt\_params = array(
'alt' => "json"
);
```
### 필드를 null로 설정하려면 어떻게 해야 하나요? ###
이 라이브러리는 초기화되지 않은 모든 속성의 기본값이기 때문에 Google API로 전송되는 객체에서 null을 제거합니다. 이를 해결하려면 null로 설정하려는 필드를 `Google\Model::NULL\_VALUE`로 지정하세요. 이는 네트워크로 전송될 때 실제 null로 대체되는 플레이스홀더입니다.
## 코드 품질 ##
PHPUnit으로 PHPUnit 테스트를 실행합니다. BaseTest.php에서 API 키와 토큰을 설정하여 모든 호출을 실행할 수 있지만, 이를 위해서는 Google Developer Console에서 몇 가지 설정이 필요합니다.
phpunit tests/
### 코딩 스타일
코딩 스타일 위반을 확인하려면 다음을 실행하세요
```
vendor/bin/phpcs src --standard=style/ruleset.xml -np
```
(수정 가능한) 코딩 스타일 위반을 자동으로 수정하려면 다음을 실행하세요
```
vendor/bin/phpcbf src --standard=style/ruleset.xml
```