@google-analytics/admin

中文文档
10.2.0发布于 2026/10/13Apache-2.0TypeScriptCommonJS近 30 天下载 25.5万

Admin client for Node.js

原始使用文档
文档目录8 节
  1. Quickstart
  2. Before you begin
  3. Installing the client library
  4. Samples
  5. Supported Node.js Versions
  6. Versioning
  7. Contributing
  8. License

Google Cloud Platform logo

Google Analytics Admin API: Nodejs Client

This library is considered to be in preview. This means it is still a work-in-progress and under active development. Any release is subject to backwards-incompatible changes at any time.

npm version

Google Analytics Admin API client for Node.js

A comprehensive list of changes in each version may be found in the CHANGELOG.

Read more about the client libraries for Cloud APIs, including the older Google APIs Client Libraries, in Client Libraries Explained.

Table of contents:

Quickstart

Before you begin

  1. Select or create a Cloud Platform project.
  2. Enable billing for your project.
  3. Enable the Google Analytics Admin API API.
  4. Set up authentication so you can access the API from your local workstation.

Installing the client library

npm install @google-analytics/admin

Samples

Samples are in the samples/ directory. Each sample's README.md has instructions for running its sample.

SampleSource Code
acknowledge user data collectionsource code
approve display video360 advertiser link proposalsource code
archive audiencesource code
archive custom dimensionsource code
archive custom metricsource code
batch create access bindingssource code
batch delete access bindingssource code
batch get access bindingssource code
batch update access bindingssource code
cancel display video360 advertiser link proposalsource code
create access bindingsource code
create ad sense linksource code
create audiencesource code
create big query linksource code
create calculated metricsource code
create channel groupsource code
create conversion eventsource code
create custom dimensionsource code
create custom metricsource code
create data streamsource code
create display video360 advertiser linksource code
create display video360 advertiser link proposalsource code
create event create rulesource code
create event edit rulesource code
create expanded data setsource code
create firebase linksource code
create google ads linksource code
create key eventsource code
create measurement protocol secretsource code
create propertysource code
create reporting data annotationsource code
create rollup propertysource code
create rollup property source linksource code
create s k ad network conversion value schemasource code
create search ads360 linksource code
create subproperty event filtersource code
delete access bindingsource code
delete accountsource code
delete ad sense linksource code
delete big query linksource code
delete calculated metricsource code
delete channel groupsource code
delete conversion eventsource code
delete data streamsource code
delete display video360 advertiser linksource code
delete display video360 advertiser link proposalsource code
delete event create rulesource code
delete event edit rulesource code
delete expanded data setsource code
delete firebase linksource code
delete google ads linksource code
delete key eventsource code
delete measurement protocol secretsource code
delete propertysource code
delete reporting data annotationsource code
delete rollup property source linksource code
delete s k ad network conversion value schemasource code
delete search ads360 linksource code
delete subproperty event filtersource code
get access bindingsource code
get accountsource code
get ad sense linksource code
get attribution settingssource code
get audiencesource code
get big query linksource code
get calculated metricsource code
get channel groupsource code
get conversion eventsource code
get custom dimensionsource code
get custom metricsource code
get data redaction settingssource code
get data retention settingssource code
get data sharing settingssource code
get data streamsource code
get display video360 advertiser linksource code
get display video360 advertiser link proposalsource code
get enhanced measurement settingssource code
get event create rulesource code
get event edit rulesource code
get expanded data setsource code
get global site tagsource code
get google signals settingssource code
get key eventsource code
get measurement protocol secretsource code
get propertysource code
get reporting data annotationsource code
get reporting identity settingssource code
get rollup property source linksource code
get s k ad network conversion value schemasource code
get search ads360 linksource code
get subproperty event filtersource code
get subproperty sync configsource code
get user provided data settingssource code
list access bindingssource code
list account summariessource code
list accountssource code
list ad sense linkssource code
list audiencessource code
list big query linkssource code
list calculated metricssource code
list channel groupssource code
list conversion eventssource code
list custom dimensionssource code
list custom metricssource code
list data streamssource code
list display video360 advertiser link proposalssource code
list display video360 advertiser linkssource code
list event create rulessource code
list event edit rulessource code
list expanded data setssource code
list firebase linkssource code
list google ads linkssource code
list key eventssource code
list measurement protocol secretssource code
list propertiessource code
list reporting data annotationssource code
list rollup property source linkssource code
list s k ad network conversion value schemassource code
list search ads360 linkssource code
list subproperty event filterssource code
list subproperty sync configssource code
provision account ticketsource code
provision subpropertysource code
reorder event edit rulessource code
run access reportsource code
search change history eventssource code
submit user deletionsource code
update access bindingsource code
update accountsource code
update attribution settingssource code
update audiencesource code
update big query linksource code
update calculated metricsource code
update channel groupsource code
update conversion eventsource code
update custom dimensionsource code
update custom metricsource code
update data redaction settingssource code
update data retention settingssource code
update data streamsource code
update display video360 advertiser linksource code
update enhanced measurement settingssource code
update event create rulesource code
update event edit rulesource code
update expanded data setsource code
update google ads linksource code
update google signals settingssource code
update key eventsource code
update measurement protocol secretsource code
update propertysource code
update reporting data annotationsource code
update s k ad network conversion value schemasource code
update search ads360 linksource code
update subproperty event filtersource code
update subproperty sync configsource code
acknowledge user data collectionsource code
archive custom dimensionsource code
archive custom metricsource code
create conversion eventsource code
create custom dimensionsource code
create custom metricsource code
create data streamsource code
create firebase linksource code
create google ads linksource code
create key eventsource code
create measurement protocol secretsource code
create propertysource code
delete accountsource code
delete conversion eventsource code
delete data streamsource code
delete firebase linksource code
delete google ads linksource code
delete key eventsource code
delete measurement protocol secretsource code
delete propertysource code
get accountsource code
get conversion eventsource code
get custom dimensionsource code
get custom metricsource code
get data retention settingssource code
get data sharing settingssource code
get data streamsource code
get key eventsource code
get measurement protocol secretsource code
get propertysource code
list account summariessource code
list accountssource code
list conversion eventssource code
list custom dimensionssource code
list custom metricssource code
list data streamssource code
list firebase linkssource code
list google ads linkssource code
list key eventssource code
list measurement protocol secretssource code
list propertiessource code
provision account ticketsource code
run access reportsource code
search change history eventssource code
update accountsource code
update conversion eventsource code
update custom dimensionsource code
update custom metricsource code
update data retention settingssource code
update data streamsource code
update google ads linksource code
update key eventsource code
update measurement protocol secretsource code
update propertysource code

Supported Node.js Versions

Our client libraries follow the Node.js release schedule. Libraries are compatible with all current active and maintenance versions of Node.js. If you are using an end-of-life version of Node.js, we recommend that you update as soon as possible to an actively supported LTS version.

Google's client libraries support legacy versions of Node.js runtimes on a best-efforts basis with the following warnings:

  • Legacy versions are not tested in continuous integration.
  • Some security patches and features cannot be backported.
  • Dependencies cannot be kept up-to-date.

Client libraries targeting some end-of-life versions of Node.js are available, and can be installed through npm dist-tags. The dist-tags follow the naming convention legacy-(version). For example, npm install @google-analytics/admin@legacy-8 installs client libraries for versions compatible with Node.js 8.

Versioning

This library follows Semantic Versioning.

More Information: Google Cloud Platform Launch Stages

Contributing

Contributions welcome! See the Contributing Guide.

Please note that this README.md and a variety of configuration files in this repository (including .nycrc and tsconfig.json) are generated from a central template.

License

Apache Version 2.0

See LICENSE

版本与发布记录

@google-analytics/admin 共发布 58 个版本,首次发布于 2020/07/07;过去 12 个月发布了 6 个版本。

版本发布日期距今
10.2.0latest2026/10/131 个月前
10.1.12026/09/291 个月前
10.1.02026/09/092 个月前
10.0.02026/08/053 个月前
9.2.0legacy-182026/06/264 个月前
9.1.02026/05/026 个月前

其他发布通道:legacy-10 → 3.2.0,legacy-12 → 4.9.0,legacy-18 → 9.2.0。

关于 @google-analytics/admin 的常见问题

@google-analytics/admin 是什么?

Admin client for Node.js

如何安装 @google-analytics/admin?

在项目目录运行 npm install @google-analytics/admin,或使用 pnpm add / yarn add / bun add。

@google-analytics/admin 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@google-analytics/admin 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@google-analytics/admin 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@google-analytics/admin 可以商用吗?

@google-analytics/admin 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@google-analytics/admin 的下载量有多少?

根据 npm 官方下载统计,@google-analytics/admin 在 2026/10/17 – 2026/11/15 这 30 天内被下载 254,702 次,日均约 8,490 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@google-analytics/admin 还在维护吗?

最新版本 10.2.0 发布于 2026/10/13(1 个月前);至今共发布 58 个版本,其中过去 12 个月发布了 6 个;首次发布于 2020/07/07。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。