README

已弃用

《joomla/google》包已弃用，没有进一步的更新计划。

使用 Google 包

Google 包旨在为使用各种 Google API 提供一个简单直接的接口。您可以在https://developers.google.com/products/找到 API 列表和每个 API 的文档。

实例化 Google

实例化 Google 很简单

use Joomla\Google\Google;

$google = new Google;

这会创建一个通用的 Google 对象，可用于实例化特定 Google API 的对象。

有时需要指定额外的选项。这可以通过注入具有您首选选项的注册对象来完成

use Joomla\Google\Google;
use Joomla\Registry\Registry;

$options = new Registry;
$options->set('clientid', 'google_client_id.apps.googleusercontent.com');
$options->set('clientsecret', 'google_client_secret');

$google = new Google($options);

访问 JGoogle API

Google 包将 API 分为两种类型：数据 API 和嵌入 API。数据 API 使用 Joomla\Http 从 Google 发送和接收数据。嵌入 API 输出 HTML、JavaScript 和 XML，以便在网页中嵌入来自 Google 的信息。

Google 包仍然不完整，但已实现了五个对象 API

数据：Google 日历、Google AdSense、Google Picasa

嵌入：Google 地图、Google 分析

一旦创建了一个 Google 对象，就可以简单地使用它来为每个单个 API 创建对象

$calendar = $google->data('calendar');

或

$analytics = $google->data('analytics');

使用 API

以下是一个演示使用日历 API 的示例

use Joomla\Google\Google;
use Joomla\Registry\Registry;

$options = new Registry;

// Client ID and Client Secret can be obtained  through the Google API Console (https://code.google.com/apis/console/).
$options->set('clientid', 'google_client_id.apps.googleusercontent.com');
$options->set('clientsecret', 'google_client_secret');
$options->set('redirecturi', JURI::current());

$google = new Google($options);

// Get a calendar API object
$calendar = $google->data('calendar');

// If the client hasn't been authenticated via OAuth yet, redirect to the appropriate URL and terminate the program
if (!$calendar->isAuth())
{
	JResponse::sendHeaders();
	die();
}

// Create a new Google Calendar called "Hello World."
$calendar->createCalendar('Hello World');

通过 Composer 安装

将 "joomla/google": "2.0.*@dev" 添加到 composer.json 中的 require 块，然后运行 composer install。

{
	"require": {
		"joomla/google": "2.0.*@dev"
	}
}

或者，您可以直接从命令行运行以下命令

composer require joomla/google "2.0.*@dev"

joomla / google

维护者

详细信息