Báo cáo GAQL (campaign, ad_group, ad_group_ad, keyword_view, conversion_action, geographic_view, segments.device…)

GoogleAdsService.SearchStream

POST/{version}/customers/{customer_id}/googleAds:searchStreamGọi qua 360: POST https://partner.quantri360.com/v1/google/{version}/customers/{customer_id}/googleAds:searchStream

Sắp mở. API này đã chạy thật qua 360 và đang được chốt giá — bạn có thể đọc tài liệu và chuẩn bị tích hợp trước.

Mô tả API

Báo cáo Google Ads bằng GAQL — 360 dùng cho chiến dịch, nhóm, quảng cáo, từ khóa, chuyển đổi, vị trí, thiết bị. Trả toàn bộ kết quả theo luồng (mảng các lô).

Tên trường trả về theo camelCase (REST); tiền ở costMicros = micro đơn vị (÷ 1.000.000).

Request

Địa chỉ

POST https://partner.quantri360.com/v1/google/{version}/customers/{customer_id}/googleAds:searchStream

Xác thực & gian hàng

Tên	Vị trí	Kiểu	Mẫu	Mô tả
Authorization	header	header	Bearer q360_live_ab12cd34_…	Khóa API của brand (tạo ở mục API key). Bắt buộc với mọi request. Brand suy từ key — không truyền mã brand.
platform_shop_id	query	string	1234567890	Customer ID Google Ads (chỉ số) brand đã nối với 360 — lấy ở GET /v1/platforms; phải trùng customers/{customer_id} trong đường dẫn.

Tham số request

Tên	Vị trí	Kiểu	Bắt buộc	Mẫu	Mô tả
version	path	string	Có	v23	Phiên bản Google Ads API — dùng bản đang hỗ trợ (v23 trở lên tại 10/2026). Google gỡ bản cũ định kỳ: bản đã gỡ trả trang lỗi HTML 404, bản sắp gỡ trả UNSUPPORTED_VERSION.
customer_id	path	string	Có	1234567890	Customer ID (chỉ số) đã nối với 360.
query	body	string	Có	SELECT campaign.id, campaign.name, metrics.cost_micros, metrics.clicks, metrics.conversions FROM campaign WHERE segments.date BETWEEN '2026-10-01' AND '2026-10-19'	Câu GAQL.

Ví dụ request

curl -s -X POST "https://partner.quantri360.com/v1/google/v23/customers/1234567890/googleAds:searchStream" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"SELECT campaign.id, campaign.name, metrics.cost_micros, metrics.clicks FROM campaign WHERE segments.date DURING LAST_7_DAYS"}'

Python

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.post(
    "https://partner.quantri360.com/v1/google/v23/customers/1234567890/googleAds:searchStream",
    params={},
    json={
        "query": "SELECT campaign.id, campaign.name, metrics.cost_micros, metrics.clicks FROM campaign WHERE segments.date DURING LAST_7_DAYS"
    },
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=60,
)
print(r.status_code)
print(r.json())

Node.js

const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/google/v23/customers/1234567890/googleAds:searchStream');
for (const [k, v] of Object.entries({})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
  method: 'POST',
  headers: { Authorization: `Bearer ${KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"query":"SELECT campaign.id, campaign.name, metrics.cost_micros, metrics.clicks FROM campaign WHERE segments.date DURING LAST_7_DAYS"}),
});
console.log(r.status, await r.json());

PHP

<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/google/v23/customers/1234567890/googleAds:searchStream' . '?' . http_build_query([]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key, 'Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"query":"SELECT campaign.id, campaign.name, metrics.cost_micros, metrics.clicks FROM campaign WHERE segments.date DURING LAST_7_DAYS"}');
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;

Response

Tham số phản hồi (nguyên của Google Ads)

Tên	Kiểu	Mô tả
[]	object[]	Mảng lô.
results	object[]
campaign	object	{resourceName, id, name, status}
metrics	object	{costMicros, clicks, impressions, conversions}
segments	object	{date, device…}
fieldMask	string
requestId	string

Bắt đầu dùng

Đăng ký tài khoản Partner
Mở loại dữ liệu thuộc nhóm Google Ads ở trang nền tảng
Tạo API key (tick kênh Google Ads)
Gọi theo ví dụ ở trên

Báo cáo GAQL (campaign, ad_group, ad_group_ad, keyword_view, conversion_action, geographic_view, segments.device…) — API Google Ads