Введение
API Google Plus для разработчиков позволяет получать общедоступные данные из Google+. В этом руководстве w3resource обсуждает обзор API Google Plus, за которым следует подробное руководство по всем необходимым шагам, которые необходимо выполнить для успешного извлечения общедоступных данных из Google+.
Цель API Google+ — предоставить программный интерфейс, позволяющий интегрировать приложение или веб-сайт. с Google+.
Google предполагает ограничение на использование API Google+ — у каждого разработчика есть квота . Мы увидим это, когда будем обсуждать консоль Google API.
Google использует протокол OAuth2.0 для авторизации вашего приложения, когда оно пытается получить доступ к данным пользователя.
Он в основном использует стандартный метод HTTP с помощью дизайна RESTful API для извлечения и обработки пользовательских данных.
Итак, чтобы получить информация профиля пользователя, синтаксис команды, которую необходимо использовать, следующий:
GET https://www.googleapis.com/plus/v1/people/userId
Где userId — это идентификатор пользователя, информацию профиля которого вы хотите получить.
Google использует формат данных JSON для представления ресурсов в API. .
Вы можете передать несколько параметров при извлечении данных с помощью Google+ API. В следующей таблице показаны используемые общие параметры :
| Параметр | Значение | Описание |
|---|---|---|
| обратный вызов | строка | Если вы хотите использовать JSONP с API, здесь указывается функция JavaScript, в которую будут передаваться данные ответа. |
| fields | string | Для повышения производительности, если вы хотите включить только определенные поля, называемые частичным ответом, здесь указывается список полей. |
| key | string | Ключ API, предоставленный зарегистрированному разработчику. Используется для авторизации соответствующего приложения, когда оно пытается получить доступ к данным пользователя. |
| access_token | string | токен OAuth 2.0 для текущего пользователя. |
| prettyPrint | boolean | Вы можно установить значение true, чтобы сделать код более читабельным, добавив отступы и разрывы строк. |
| userIp | boolean | Это необходимо для определения IP-адреса пользователя, данные которого запрашиваются при выполнении вызова API. Если серверное приложение делает вызов API, это сохраняет ограничение, подразумеваемое принудительной квотой пользователя. |
Хотя каждый ресурс API (например, люди , activity) обладает некоторыми уникальными свойствами, есть свойства, общие для всех ресурсов. В следующей таблице показаны свойства, общие для всех ресурсов:
| Свойство | Value | Описание |
|---|---|---|
| displayName | string | Имя ресурса. Может использоваться для отображения данных пользователю. |
| id | string | Для повышения производительности , если вы хотите включить только определенные поля, называемые частичным ответом, это определяет список полей. |
| kind | строка | Определяет, какой вид ресурса представляет объект JSON. Если во время синтаксического анализа пользовательских данных (в формате JSON) обнаружен неизвестный объект, это может помочь решить, как анализировать его программно. |
| url | строка | Основной URL или постоянная ссылка для связанного ресурса. |
Если API возвращает большое количество коллекций, каждый ответ состоит из ограниченного количества элементов, которые могут быть получены с помощью maxResults. Передавая значение свойства nextPageToken каждого ответа в свойство pageToken, можно получить следующий запрос. Повторяя этот процесс, вы можете получить полный ответ.
После того, как вы закончите писать выше, пора запачкать руки, но попробовать простое приложение.
Укажите в браузере code.google.com/apis/console/, и он перенесет вас на страницу входа в консоль API.
Укажите в браузере code.google.com/apis/console /и вы перейдете на страницу входа в консоль API. После того, как вы вошли в систему со своим адресом электронной почты и паролем, появится следующее. Щелкните «Создать проект».
В В списке служб найдите API Google+ и нажмите «Выкл.», чтобы включить его.
На следующем экране отметьте «Я согласен …» и нажмите «Принять». Вы увидите, что кнопка рядом с Google+ API изменилась на следующее:
Теперь нажмите «Доступ к API», и он попросит вас «Создать идентификатор клиента OAuth 2.0 ..».
На следующем экране укажите название продукта, загрузите изображение в качестве логотипа вашего проекта и нажмите« Далее ».
На следующем экране вы получите следующую информацию —
Эта информация потребуется для выполнения вызова API.
Мы создадим простую форму. В этой форме, если указан идентификатор пользователя, он вернет определенную информацию об этом пользователе.
Ниже приведен код простой HTML-страницы, содержащей форму:
Пример Google + API Вставьте идентификатор:
Для выполнения этой задачи мы будем использовать клиент Google API PHP. Итак, вам необходимо его загрузить. Укажите в браузере code.google.com/p/google-api -php-client/и получите PHP-клиент Google API. Разархивируйте его и сохраните в папке, где будут находиться html- и php-файлы вашего приложения.
Ниже приведен PHP-код нашего приложения.
php/* * Copyright 2011 Google Inc. * * Лицензия Apache License, версия 2.0 («Лицензия»); * вы не можете использовать этот файл, кроме как в соблюдение Лицензии. * Вы можете получить копию Лицензии по адресу * * http://www.apache.org/licenses/LICENSE-2.0 * * Если это не требуется применимым законодательством или не согласовано в письменной форме, программное обеспечение *, распространяемое в соответствии с Лицензия распространяется на УСЛОВИЯХ «КАК ЕСТЬ» * БЕЗ ГАРАНТИЙ ИЛИ УСЛОВИЙ ЛЮБОГО РОДА, явных или подразумеваемых. * См. Лицензию для sp конкретный язык, регулирующий разрешения и * ограничения в соответствии с Лицензией. */require_once 'google-api-php-client/src/apiClient.php'; require_once 'google-api-php-client/src/contrib/apiPlusService.php'; session_start (); $ id = $ _POST ['идентификатор']; $ client = новый apiClient (); $ client-> setApplicationName («Стартовое приложение Google+ PHP»); //oauth2_client_id, oauth2_client_secret и для регистрации вашего oauth2_redirect_uri. $ client-> setClientId ('357142505911.apps.googleusercontent.com'); $ client-> setClientSecret ('LbJa7YOJ1Th-e-TOosEJxI4A'); $ client-> setRedirectUri ('https://www.w3resource.com/API/google-plus/example.php'); $ client-> setDeveloperKey ('AIzaSyD3stLpkt7jJw0mkMsJtM9m_zrgg26rrsI'); $ plus = новый apiPlusService ($ client); if (isset ($ _ REQUEST ['logout'])) {unset ($ _ SESSION ['access_token']); } если (isset ($ _ GET ['код'])) {$ client-> Authenticate (); $ _SESSION ['access_token'] = $ client-> getAccessToken (); заголовок ('Расположение: http://'. $ _SERVER ['HTTP_HOST']. $ _SERVER ['PHP_SELF']); } if (isset ($ _ SESSION ['access_token'])) {$ client-> setAccessToken ($ _ SESSION ['access_token']); } если ($ client-> getAccessToken ()) {$ me = $ plus-> people-> get ($ id); $ optParams = array ('maxResults' => 100); $ activity = $ plus-> activity-> listActivities ($ id, 'public', $ optParams); //Возможно, токен доступа был обновлен лениво. $ _SESSION ['access_token'] = $ client-> getAccessToken (); } еще {$ authUrl = $ client-> createAuthUrl (); }?> Пример приложения Google+
php if (isset ($ me) && isset ($ действия)):?> Ваши действия: php foreach ($ activity ['items'] as $ activity):?> php endforeach?> php endif?> php if (isset ($ authUrl)) {print " Подключи меня! "; } else {//print " Выйти "; }?>
К HTML-коду прикреплена таблица стилей. Вот он
/* * Copyright 2011 Google Inc. * Лицензия Apache License версии 2.0 («Лицензия»); * вы не можете использовать этот файл, кроме как в соответствии с Лицензией. * Вы можете получить копию Лицензии по адресу * * http://www.apache.org/licenses/LICENSE-2.0 * * Если это не требуется применимым законодательством или не согласовано в письменной форме, программное обеспечение *, распространяемое по Лицензии, распространяется на ОСНОВАНИЕ "КАК ЕСТЬ" * БЕЗ ГАРАНТИЙ ИЛИ УСЛОВИЙ ЛЮБОГО РОДА, явных или подразумеваемых. * См. Лицензию для получения информации о разрешениях и * ограничениях на конкретном языке в соответствии с Лицензией. */body {font-family: Arial, sans-serif; маржа: авто;}. поле {граница: .5em solid # E3E9FF; -webkit-box-orient: вертикальный; -webkit-box-align: center; -moz-box-orient: вертикальный; -moz-box-align: center; дисплей: блок; box-orient: вертикальный; box-align: center; ширина: 750 пикселей; высота: авто; маржа: авто; отступ: 10 пикселей; перенос слов: слово-разрыв; переполнение текста: многоточие;}. меня {-webkit-box-flex: 1; -moz-box-flex: 1; box-flex: 1; width: 700px;}. действия {-webkit-box-flex: 2; -moz-box-flex: 2; box-flex: 2; width: 100%;}. activity {margin: 10px;} заголовок {color: # 000; отступ: 2px 5px; размер шрифта: 100%; ширина: 400 пикселей; маржа: авто; text-align: center} заголовок h1.logo {margin: 6px 0; отступ: 0; курсор: указатель; размер шрифта: 24 пикселя; высота строки: 20 пикселей;}. логин {размер-шрифта: 200%; дисплей: блок; маржа: авто; курсор: указатель; выравнивание текста: центр; font-weight: жирный; цвет: # 2779AA; высота строки: нормальный;}. выйти из системы {font-weight: normal; padding-top: -5px; margin-top: 0px;}
В приведенном выше коде PHP измените clientId в строке номер 28, измените ClientSecret в строке номер 29, измените RedirectUri в строке номер 30, измените DeveloperKey в строка номер 31, с вашим собственным. Также помните, что в консоли Google API измените RedirectUri, как вы указали в php-коде вашего приложения.
Теперь укажите в браузере URL-адрес вашего приложения и укажите идентификатор пользователя. Вы можете получить идентификатор пользователя, набрав «имя пользователя профиля Google», где имя пользователя - это существующее имя пользователя. Вы получите URL-адрес типа https://plus.google.com/XXXXXXXXXXXXXXXX. «xx ..» - это число, и это идентификатор пользователя. Приложение вернет вам имя, слоган, информацию о пользователе, идентификатор которого вы указали.
В следующей части руководства мы настроим это приложение на лучшее, а также мы будет искать другие ресурсы из API.
