Google API Endpoints & Fields
This article provides a consolidated reference of Google API endpoints and reporting fields used by Zitcha to create, manage, and report on campaigns across planning and orders workflows.
This article outlines how Zitcha interacts with advertising platforms in Zitcha 1.0 (Orders). It documents the key campaign, ad set, ad, product, and reporting endpoints that underpin how campaigns are created, managed, and measured.
Google Ads API
Campaign Management
| Service | Endpoint | HTTP |
|---|---|---|
| Campaign Management | customers/{customer_id}/campaigns:mutate | POST |
Fields: id, name, status, advertising_channel_type, advertising_channel_sub_type, start_date_time, end_date_time, campaign_budget, bidding_strategy_type
Campaign Metrics/ Insights
| Service | Endpoint | HTTP |
|---|---|---|
| Campaign Metrics/Insights | customers/{customer_id}/googleAds:searchStream | POST |
Fields: cost_micros, average_cpc, average_cpm, ctr, clicks, impressions, conversions_value, conversions, video_trueview_views, video_trueview_view_rate, trueview_average_cpv
Campaign Store Insights
| Service | Endpoint | HTTP |
|---|---|---|
| Campaign Store Insights | customers/{customer_id}/googleAds:searchStream | POST |
Fields: all_conversions, all_conversions_value
Segments: conversion_action_category (filtered to STORE_SALE)
Campaign Breakdown Insights
| Service | Endpoint | HTTP |
|---|---|---|
| Campaign Breakdown Insights | customers/{customer_id}/googleAds:searchStream | POST |
Fields: clicks, impressions, average_cpc, average_cpm, cost_micros
Segments: date
Ad Groups
| Service | Endpoint | HTTP |
|---|---|---|
| Ad Groups | customers/{customer_id}/adGroups:mutate | POST |
Fields: id, name, status
Ads
| Service | Endpoint | HTTP |
|---|---|---|
| Ads | customers/{customer_id}/adGroupAds:mutate | POST |
Fields: ad.id, ad.name, status
Campaign Budgets
| Service | Endpoint | HTTP |
|---|---|---|
| Campaign Budgets | customers/{customer_id}/campaignBudgets:mutate | POST |
Fields: amount_micros, total_amount_micros, explicitly_shared
Ad Group Criteria (Audience / Product Targeting)
| Service | Endpoint | HTTP |
|---|---|---|
| Ad Group Criteria | customers/{customer_id}/adGroupCriteria:mutate | POST |
Fields: Targeting criteria (audiences, product groups, gender)
Campaign Criteria (Location Targeting)
| Service | Endpoint | HTTP |
|---|---|---|
| Campaign Criteria | customers/{customer_id}/campaignCriteria:mutate | POST |
Fields: Location targeting criteria
Geographic Target Constants
| Service | Endpoint | HTTP |
|---|---|---|
| Geographic Target Constants | geoTargetConstants:suggest | POST |
Fields: id, name, target_type, canonical_name, status
Remarketing Audiences
| Service | Endpoint | HTTP |
|---|---|---|
| Remarketing Audiences | customers/{customer_id}/googleAds:searchStream | POST |
Resource: user_list
Fields: id, name, type, size_for_search, membership_life_span, size_range_for_search, size_range_for_display, size_for_display, description, membership_status, logical_user_list.rules
User Interests (In-Market & Affinity)
| Service | Endpoint | HTTP |
|---|---|---|
| User Interests | customers/{customer_id}/googleAds:searchStream | POST |
Resource: user_interest
Fields: name, taxonomy_type, user_interest_id
Filters: taxonomy_type = IN_MARKET or taxonomy_type = AFFINITY
Google Content API for Shopping (Merchant Center)
Products
| Service | Endpoint | HTTP |
|---|---|---|
| List Products | {merchantId}/products | GET (paginated) |
Fields: id, offerId, imageLink, price (value, currency)
Products Statuses
| Service | Endpoint | HTTP |
|---|---|---|
| List Product Statuses | {merchantId}/productstatuses | GET (paginated) |
| Get Product Status | {merchantId}/productstatuses/{productId} | GET |
| Batch Get Product Statuses | productstatuses/batch | POST (custom batch) |
Batch Fields: method, productId, merchantId, batchId
Updated about 22 hours ago