# Google Marketing Platform Admin

> The Google Marketing Platform Admin API is the administrative control plane for a Google Marketing Platform organization. It manages links between a GMP organization and Google Analytics accounts, sets the service level of Analytics properties (STANDARD or paid 360), and reports per-property event usage and billing. It is REST + gRPC, OAuth 2.0 only, and at ALPHA launch stage. This file was GENERATED by API Evangelist from the provider's published artifacts on 2026-08-13 — the provider serves no /llms.txt (404 on developers.google.com and marketingplatform.google.com).

## Facts an agent needs first

- Base URL: https://marketingplatformadmin.googleapis.com
- Version: v1alpha (URI path). Discovery revision 20260813.
- Stability: ALPHA — "an unstable early preview stage". The Google APIs Terms of Service deprecation commitment does NOT cover alpha features.
- Auth: OAuth 2.0 authorization code only. No API keys. `Authorization: Bearer <token>`.
- Scopes: `https://www.googleapis.com/auth/marketingplatformadmin.analytics.read` (read), `https://www.googleapis.com/auth/marketingplatformadmin.analytics.update` (write).
- A Cloud quota project is REQUIRED and is not set by default. Without it, correctly authenticated calls still fail.
- Identifiers are full relative resource names: `organizations/{org_id}`, `organizations/{org_id}/analyticsAccountLinks/{link_id}`. Never bare ids.
- Pagination: `pageSize` + `pageToken` in, `nextPageToken` out.
- Rate limits: 1,200 requests/min and 300 writes/min per project; 600 and 120 per user. Exhaustion returns **HTTP 403 with reason `rateLimitExceeded`, not 429**. No rate-limit response headers.
- Errors: Google JSON envelope (`error.code`, `error.message`, `error.status`, `error.errors[].reason`). NOT RFC 9457 problem+json. Branch on `error.errors[].reason` or `error.status`.
- Idempotency: none. `createAnalyticsAccountLink` has no replay protection — list before retrying.
- Events: none. No webhooks, no streaming, no AsyncAPI.

## Operations

- `listOrganizations` — GET /v1alpha/organizations — list GMP organizations the caller can access.
- `getOrganization` — GET /v1alpha/{name} — look up one organization. (Discovery only; absent from the OpenAPI in this repo.)
- `listAnalyticsAccountLinks` — GET /v1alpha/{parent}/analyticsAccountLinks — list Analytics accounts linked to an organization.
- `createAnalyticsAccountLink` — POST /v1alpha/{parent}/analyticsAccountLinks — link an Analytics account. Write scope. Not idempotent.
- `deleteAnalyticsAccountLink` — DELETE /v1alpha/{name} — unlink an Analytics account. Write scope. Destructive.
- `setPropertyServiceLevel` — POST /v1alpha/{analyticsAccountLink}:setPropertyServiceLevel — set a property to STANDARD or 360. Write scope. Commercially consequential.
- `reportPropertyUsage` — POST /v1alpha/{organization}:reportPropertyUsage — per-property event usage plus BillInfo. (Discovery only.)
- `findSalesPartnerManagedClients` — POST /v1alpha/{organization}:findSalesPartnerManagedClients — clients managed by a sales partner. (Discovery only.)

## Specs

- Discovery Document (provider, complete, 8 methods): https://marketingplatformadmin.googleapis.com/$discovery/rest?version=v1alpha
- Discovery Document, verbatim copy: openapi/google-marketing-platform-v1alpha-discovery.json
- OpenAPI 3.1 (API Evangelist, 5 of 8 methods): openapi/google-marketing-platform-v1alpha-api-openapi.yml
- Protobuf service (provider): grpc/google-marketing-platform-marketingplatform-admin.proto
- Protobuf resources (provider): grpc/google-marketing-platform-resources.proto
- gRPC service config, timeouts and retry (provider): grpc/google-marketing-platform-grpc-service-config.json
- Service config, scopes per method (provider): grpc/google-marketing-platform-service-config.yaml
- Overlay of API Evangelist enhancements: overlays/google-marketing-platform-v1alpha-api-overlay.yaml

## Docs

- Developer guide: https://developers.google.com/analytics/devguides/config/gmp/v1
- REST reference: https://developers.google.com/marketing-platform/devguides/api/admin/v1/rest
- Quickstart: https://developers.google.com/marketing-platform/devguides/api/admin/v1/quickstart
- Client libraries: https://developers.google.com/marketing-platform/devguides/api/admin/v1/client-libraries
- Limits and quotas: https://developers.google.com/marketing-platform/devguides/api/admin/v1/quotas
- Changelog: https://developers.google.com/marketing-platform/devguides/api/admin/v1/changelog
- Portal: https://marketingplatform.google.com
- Issue tracker: https://issuetracker.google.com/issues/new?component=1603054

## Client libraries

Purpose-built (GAPIC, generated from the protos above):

- Java: `com.google.ads-marketingplatform:admin` 0.42.0
- PHP: `googleads/marketingplatform-admin` v0.5.0
- Python: `google-ads-marketingplatform-admin` 0.6.0
- Node: `@google-ads/marketing-platform-admin` 0.5.0
- .NET: `Google.Ads.MarketingPlatform.Admin.V1Alpha` 1.0.0-alpha02
- Ruby: `google-apis-marketingplatformadmin_v1alpha` 0.9.0 (Discovery-generated; no GAPIC Ruby client)

Generic Discovery clients that also reach this API: `googleapis` (npm), `google-api-python-client` (PyPI), `google.golang.org/api/marketingplatformadmin/v1alpha` (Go), `google/apiclient` (Packagist).

Avoid `com.google.apis:google-api-services-marketingplatformadmin` — pinned to Discovery revision 20240529 and missing every method added since 2024-04-09.

Full detail with versions and dates: packages/google-marketing-platform-packages.yml

## Agent surfaces

- MCP server: NONE published by the provider. A derived candidate tool set is at mcp/google-marketing-platform-mcp.yml (`deployment.mode: none`).
- A2A agent card: NONE. `/.well-known/agent-card.json` and `/.well-known/agent.json` returned 404 on the API host, the docs host and the portal host.
- Agent skills: skills/_index.yml

## Artifacts in this repo

- Authentication: authentication/google-marketing-platform-authentication.yml
- OAuth scopes: scopes/google-marketing-platform-scopes.yml
- Conventions: conventions/google-marketing-platform-conventions.yml
- Errors: errors/google-marketing-platform-problem-types.yml
- Rate limits: rate-limits/google-marketing-platform-rate-limits.yml
- Plans and pricing: plans/google-marketing-platform-plans-pricing.yml
- Lifecycle: lifecycle/google-marketing-platform-lifecycle.yml
- Changelog: changelog/google-marketing-platform-changelog.yml
- Data model: data-model/google-marketing-platform-data-model.yml
- Conformance: conformance/google-marketing-platform-conformance.yml
- Packages: packages/google-marketing-platform-packages.yml
- Well-known probe: well-known/google-marketing-platform-well-known.yml
- Domain security: security/google-marketing-platform-domain-security.yml
- Vulnerability disclosure: security/google-marketing-platform-vulnerability-disclosure.yml
- Agentic access: agentic-access/google-marketing-platform-agentic-access.yml