Начните работу с REST

Чтобы начать использовать API библиотеки Google Фото, настройте свой проект, включив API через консоль API Google и настроив идентификатор клиента OAuth 2.0.

Ваше приложение взаимодействует с Google Фото от имени пользователя Google Фото. Например, когда вы создаете альбомы в библиотеке Google Фото пользователя или загружаете мультимедийные элементы в учетную запись пользователя в Google Фото, пользователь авторизует эти запросы API через протокол OAuth 2.0 .

Идентификатор клиента OAuth 2.0 позволяет пользователям вашего приложения входить в систему, проходить аутентификацию и, таким образом, использовать API библиотеки. API библиотеки не поддерживает учетные записи служб; Чтобы использовать этот API, пользователи должны войти в действующую учетную запись Google.

Настройте свое приложение

Включить API

Прежде чем вы сможете использовать API библиотеки, вы должны включить его для своего проекта.

Перейдите в консоль Google API .
В строке меню выберите проект или создайте новый проект.
Чтобы открыть библиотеку API Google, в меню навигации выберите API и службы > Библиотека .
Найдите «API библиотеки Google Фото». Выберите правильный результат и нажмите «Включить» .

Запросить идентификатор клиента OAuth 2.0

Выполните следующие действия, чтобы запросить идентификатор клиента OAuth и настроить его для своего приложения. В этом примере используется приложение, в котором весь поток OAuth обрабатывается на стороне сервера, например, в наших примерах. Процесс установки может отличаться для других сценариев реализации .

Перейдите в консоль Google API и выберите свой проект.
В меню выберите API и службы > Учетные данные .
На странице «Учетные данные» нажмите «Создать учетные данные» > «Идентификатор клиента OAuth» .
Выберите тип приложения . В этом примере типом приложения является веб-приложение .
Зарегистрируйте источники, из которых вашему приложению разрешен доступ к API Google, следующим образом:
1. Чтобы определить идентификатор клиента, введите имя.
2. В поле «Авторизованные источники JavaScript» введите источник вашего приложения. В этом поле нельзя использовать подстановочные знаки.
  Вы можете указать несколько источников, чтобы ваше приложение могло работать на разных протоколах, доменах или поддоменах. Введенные вами URL-адреса могут запускать запросы OAuth.
  В следующем примере показан локальный URL-адрес разработки (в наших примерах используется localhost:8080 ) и рабочий URL-адрес.
```
http://localhost:8080
https://myproductionurl.example.com
```
3. Поле URI авторизованного перенаправления — это конечная точка, которая получает ответы от сервера OAuth 2.0. Обычно это включает в себя вашу среду разработки и указывает путь в вашем приложении.
```
http://localhost:8080/auth/google/callback
https://myproductionurl.example.com/auth/google/callback
```
4. Нажмите Создать .

В появившемся диалоговом окне клиента OAuth скопируйте следующее:
- Идентификатор клиента
- Секрет клиента
Ваше приложение может получить доступ к включенным API Google, используя эти значения.

Прежде чем вы сможете запустить общедоступное приложение, имеющее доступ к API библиотеки, ваше приложение должно быть проверено Google. Когда вы тестируете приложение, на экране появляется сообщение «Непроверенное приложение», пока оно не будет проверено .

Попробуйте образец

Теперь, когда вы настроили свой проект для использования с API библиотеки, ознакомьтесь с примером приложения на GitHub. Пример приложения демонстрирует, как можно создать интеллектуальную фоторамку с помощью API библиотеки.