tipoff/laravel-google-api

Laravel 与 Google API 交互的包。

2.1.3 2021-05-06 23:57 UTC

README

Latest Version on Packagist Tests Total Downloads

这里应该放您的描述。

安装

您可以通过 composer 安装此包

composer require tipoff/laravel-google-api

您可以使用以下命令发布配置文件

php artisan vendor:publish --provider="Tipoff\GoogleApi\GoogleApiServiceProvider" --tag="google-api-config"

将以下变量添加到您的 .env 文件中,并根据您从 Google 获得的 client_secret.json 文件的内容进行设置。

GOOGLE_CLIENT_ID=
GOOGLE_PROJECT_ID=
GOOGLE_CLIENT_SECRET=
GOOGLE_REDIRECT_URIS=
GOOGLE_JAVASCRIPT_ORIGINS=

GOOGLE_API_KEY=

您可以在 GOOGLE_REDIRECT_URISGOOGLE_JAVASCRIPT_ORIGINS 设置中使用 | 字符分隔多个字符串。

从 Google 获取 API 访问令牌并将其插入到 keys 表中,为下一步提供标识符。 (确保 value 字段包含格式正确的 JSON 格式的令牌。)

将您的 .env 文件中的 GOOGLE_ACCESS_TOKEN_SLUG 的值设置为您的 keys 表条目中的 slug 名称。

注意:如果您需要根据服务对客户端密钥字段或访问令牌值进行自定义,您可以在 .env 文件中设置 config/google-api.php 中找到的特定于服务的值。 (例如,YOUTUBE_CLIENT_ID。)

如果您未设置特定于服务的值,则默认为为每个服务设置上述选项。

模型

我们包括以下模型

模型列表

  • 谷歌商户账户
  • 密钥

对于这些模型中的每一个,此包实现了一个 授权策略,该策略扩展了 tipoff/authorization 包的角色和权限方法。此包中每个模型的策略通过包注册,无需手动注册。

这些模型也包含在此包中的 Laravel Nova 资源,并且也通过包注册,无需手动注册。

用法

// Get access token.
$accessToken = GoogleOauth::accessToken('search-console');

// Set access token.
$googleServices = app(GoogleServices::class)->setAccessToken($accessToken);

// Access services.
$searchConsole = $googleServices->searchConsole();
$myBusiness = $googleServices->myBusiness();
$youtube = $googleServices->youtube();
$youtubeAnalytics = $googleServices->youtubeAnalytics();
$analytics = $googleServices->analytics();
$place = $googleServices->places();

注意

  • 谷歌地点服务使用第三方包装来访问地点 API。有关其可用方法的文档可在 此处 找到。
  • 谷歌搜索控制台服务使用第三方包装来访问 Laravel 搜索控制台。有关其可用方法的文档可在 此处 找到。

测试

composer test

变更日志

请参阅 CHANGELOG 以获取有关最近更改的更多信息。

贡献

请参阅 CONTRIBUTING 获取详细信息。

安全漏洞

请查看 我们的安全策略 了解如何报告安全漏洞。

鸣谢

许可

MIT 许可证 (MIT)。有关更多信息,请参阅 许可文件