Chuyển đến nội dung
VI
Lấy khóa API
Duyệt tài liệu

Tham chiếu API

Google Shopping API

Lấy khóa API

Tìm kiếm Google Mua sắm sản phẩm và lấy lại giá cả, thương gia, đánh giá và liên kết sản phẩm trong cấu trúc JSON.

Tạo yêu cầu

Tham số nâng cao

Bắt đầu ở 1. Mỗi trang là một yêu cầu riêng biệt.

Google tbs Biểu thức. Bộ lọc đã hỗ trợ khác nhau theo kiểu tìm kiếm.

POSThttps://data.flashdata.dev/v1/queries/realtime
Python 3 · requests
python3 -m pip install requests
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "google_shopping",
    "query": "mechanical keyboard",
    "params": {
        "gl": "us",
        "hl": "en",
        "num": 10,
        "page": 1,
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key, "Accept": "application/json"},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
Kết quả trong phản ứng HTTPX-API-Key Xác thực

Tham số

Gởi source và query Ở tầng cao nhất. Tùy chọn nguồn thuộc về params. Có thể bỏ qua trường tùy chọn.

Nội dung yêu cầu

sourcestring / Bắt buộc
Thiết lập google_shopping.
querystring / Bắt buộc
Truy vấn tìm kiếm. Hỗ trợ Google tìm kiếm các nhà điều hành như trang web: và trong danh sách:
1 phải 2.000 Ký tựMặc định: Chưa đặt
paramsobject / Không bắt buộc
Settings cho yêu cầu này.
Mặc định: {}
callback_urlstring · nullable / Không bắt buộc
Async và chỉ một mẻ. Chung HTTPS hoàn tất URL trên cổng 443Đến 2,048 các nhân vật. Không có phân khúc người dùng hay URL. Omit, dùng null hoặc chuỗi rỗng không cho thông báo nào. Trong một mẻ, đặt nó trên mỗi câu hỏi, bên ngoài các tham số.
Mặc định: Chưa đặt

Quốc gia, địa điểm và ngôn ngữ

params.glstring / Không bắt buộc
Mã quốc gia 2 chữ cái, như chúng ta, gb, de hoặc sg. Đặt dứt khoát để chọn một nước.
Chính xác 2 Ký tựMặc định: Chưa đặt
Định dạng đã chấp nhận^[A-Za-z]{2}$
params.hlstring / Không bắt buộc
Google Ngôn ngữ giao diện. Đặt một cách rõ ràng để chọn một ngôn ngữ.
1 phải 35 Ký tựMặc định: Chưa đặt
Định dạng đã chấp nhận^[A-Za-z0-9-]+$
params.locationstring / Không bắt buộc
Đã yêu cầu địa điểm tìm kiếm, tốt hơn là một thành phố, như "London, England, United Kingdom". Tính khả thi phụ thuộc vào kiểu tìm kiếm.
1 phải 200 Ký tựMặc định: Chưa đặt

Đăng ký

params.numinteger / Không bắt buộc
Yêu cầu số lượng kết quả. FlashData không thêm giá trị mặc định cố định khi bỏ qua. Số đếm lại có thể khác nhau khi truy vấn và tìm kiếm kiểu.
1 phải 100, số nguyênMặc định: Chưa đặt
params.pageinteger / Không bắt buộc
Đã yêu cầu trang kết quả. Chuẩn bị rõ ràng. Mỗi trang là một yêu cầu khác nhau của API.
1 phải 100, số nguyênMặc định: Chưa đặt

Bộ lọc tìm kiếm

params.tbsstring / Không bắt buộc
Đã yêu cầu Google lọc tìm kiếm, như qdr:d cho ngày qua hoặc qdr:w cho tuần vừa qua. Tính khả thi phụ thuộc vào kiểu tìm kiếm.
1 phải 200 Ký tựMặc định: Chưa đặt
params.autocorrectboolean / Không bắt buộc
Yêu cầu sửa chính tả bằng true hoặc yêu cầu nó bị tắt false. Ứng xử ứng dụng phụ thuộc vào kiểu tìm kiếm; bỏ qua cần dùng GoogleHành vi.
true hay falseMặc định: Chưa đặt

Phản hồi

Realtime trở về status: done với kết xuất tìm kiếm vào results[0]. Khớp vào rồi results[0].shopping. usage.credits Ghi lại tội danh.

giá là một chuỗi hiển thị, không phải là một số bình thường. Thương gia, giao hàng và đánh giá là tùy chọn. Danh sách là kết quả tìm kiếm, chứ không phải đảm bảo cổ phiếu hay giá cả hiện tại.

Đọc kết quả

Cứu người thành công JSON trả lời response.json. Lưu cái này vào read-response.py và chạy python read-response.py. Nó chỉ dùng thôi. PythonThư viện thông thường và không có yêu cầu mới.

read-response.py
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
    raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
    print("[]")
    raise SystemExit(0)
result = response["results"][0]

output = [
    {"title": item.get("title"), "url": item.get("link"), "price": item.get("price"), "merchant": item.get("source")}
    for item in result.get("shopping", [])
]
print(json.dumps(output, ensure_ascii=False, indent=2))

Các trường sẵn sàng phụ thuộc vào yêu cầu và kiểu tìm kiếm. Những cánh đồng tùy chọn có thể bị vắng mặt, và có thể trở lại những cánh đồng khác.

Số mục đã trả lại và searchParameters.num có thể khác params.num. Dùng dãy số điện thoại trả lại để xác định kết quả thực tế.

Tất cả các trường đáp ứng
Tìm kiếmMô tả
sourcestringNguồn API đã yêu cầu.
statusstringhoàn thành khi yêu cầu thời gian thực thành công.
created_atstringThời gian tạo ra đáp ứng trong ISO 8601 Định dạng.
usage.creditsnumberCác nguồn tin cho yêu cầu, dựa trên kế hoạch của anh.
results[0].searchParametersobjectThiết lập tìm kiếm được báo cáo bởi GoogleVới yêu cầu được ghi lại là Q. Thiết lập trở lại có thể khác với các giá trị đã yêu cầu.
results[0].shoppingarrayKết quả tìm kiếm mua sắm.
results[0].shopping[].titlestringTựa đề sản phẩm.
results[0].shopping[].linkstringSản phẩm liệt kê URL.
results[0].shopping[].sourcestring · optionalTên thương nhân.
results[0].shopping[].pricestring · optionalGiá được hiển thị bao gồm định dạng tiền tệ.
results[0].shopping[].deliverystring · optionalĐã hiển thị chi tiết giao hàng.
results[0].shopping[].ratingnumber · optionalĐánh giá sản phẩm.
results[0].shopping[].ratingCountinteger · optionalSố lần đánh giá.
results[0].shopping[].imageUrlstring · optionalHình ảnh sản xuất URL.
results[0].shopping[].positionintegerVị trí kết quả.
results[0].shopping[].productIdstring · optionalGoogle Bộ nhận diện sản phẩm khi sẵn sàng.

Các trường trên mô tả giá trị mặc định JSON Trả lời đi. JSON, văn bản đơn giản và Markdown Định dạng.

Async & mẻ xe đạp cứu hộ

Không có kết quả, không có gì. Async tạo ra một công việc; một mẻ cung cấp một công việc riêng biệt trong queries[] Cho mỗi yêu cầu được chấp nhận. Theo dõi và lấy lại mỗi công việc một cách độc lập.

Gởi tới data.flashdata.dev; đọc tình trạng công việc và kết quả từ api.flashdata.dev với cùng một X-API-Key. Liên kết API Các ví dụ cơ bản dùng Python và cURL.

  1. 1. Lưu công việc IDs

    Giữ trường yêu cầu này khi chuyển sang Async. Đối với Batch, đặt mỗi yêu cầu vào trong dãy các câu hỏi của một đối tượng JSON. Lưu mọi công việc trở về ID.

    Async yêu cầu và biên lai · Batch yêu cầu cơ thể

  2. 2. Kiểm tra trạng thái

    GET https://api.flashdata.dev/v2/jobs/{jobId}

    pending / processing: cuộc thăm dò với một sự chậm trễ và kính trọng Retry-After khi có mặt. completed: Tìm kết quả đi. failed: thanh tra job.error.

    Đọc job.status, không phải là địa chỉ biên nhận.

    Kiểm tra trạng thái %s Python và cURL

    Trạng thái công việc API tham chiếu
  3. 3. Lấy kết quả

    GET https://api.flashdata.dev/v2/jobs/{jobId}/results

    Sau khi hoàn thành, xác thực kết quả đọc, sau đó lấy các 302 kho URL Không có bạn API Chìa khóa. Cứu lấy JSON bên trong 24 Giờ hoàn thành.

    Lấy kết quả l· Python và cURL · Định dạng phản hồi

    Tải về kết quả API tham chiếu

Làm ô nhiễm và thu thập kết quả hiện có không làm mất tín dụng truy vấn. Thời hạn bầu cử không hủy bỏ công việc: Giữ nó ID Thay vì nộp bản sao. Lỗi mã và hành vi thử lại.

Webhook khi hoàn tất

Đăng ký mỗi yêu cầu

Đặt callback_url ở cấp độ cao nhất của một yêu cầu đặc biệt, hoặc bên trong mỗi truy vấn trong một mẻ đá, bên ngoài params. Không cần yêu cầu duy trì webhoook riêng biệt. Yêu cầu Realtime không gửi hồi âm.

Dùng công chúng HTTPS URL trên cổng 443. FlashData PST một thông báo cho mỗi công việc với tới completed hay failed; sự kiện này chứa các liên kết, chứ không phải kết quả chính nó.

Xác nhận và xác nhận

Trả lại 2xx sau khi chấp nhận sự kiện này. Bị hủy bỏ bởi delivery_id, cũng gửi như X-Delivery-Id. Không theo dõi sự chuyển hướng.

Việc giao hàng lại thất bại thử với số mũ ngược lại, lên đến 8 Tổng cố gắng và nhiều nhất Giờ 24 sau khi hoàn tất. Tiếp tục bỏ phiếu như một sự phản đối.

Cuộc gọi lại không được ký. Xác nhận công việc ID, nguồn và thiết bị cuối thông qua các máy chủ Điểm kết thúc trạng thái xác thực trước khi xử lý thông báo. Giao hàng. ID không phải bằng chứng về tính xác thực.

Sự kiện webhook và các trường mẫu
Thông báo hoàn tất tưởng tượng
{
  "delivery_id": "completion:job_example0001",
  "id": "job_example0001",
  "source": "google_shopping",
  "status": "completed",
  "links": [
    {
      "rel": "self",
      "href": "https://api.flashdata.dev/v2/jobs/job_example0001",
      "method": "GET"
    },
    {
      "rel": "results",
      "href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
      "method": "GET"
    }
  ]
}
Tìm kiếmMô tả
delivery_idstringBộ nhận dạng giao hàng ổn định. Thông báo hủy bỏ sử dụng giá trị này; nó cũng được gửi vào X-Delivery-Id Đầu trang.
idstringJob ID.
sourcestringĐã yêu cầu nguồn dữ liệu.
statusstringhoàn thành hoặc thất bại.
linksarrayTình trạng và kết quả liên kết. Thông báo không bao gồm nội dung hoặc phím API.
links[].relstringbản thân hoặc kết quả.
links[].hrefstringQuản lý tuyệt đối API URL; Xác thực với của bạn API Chìa khóa.
links[].methodstringGET.

Hợp đồng mạng và URL hạn chế

Đang phục hồi lỗi

Tìm kiếm hoàn tất có thể chứa ít hơn yêu cầu. Kiểm tra gl, hl, vị trí và bộ lọc; các trường giàu có tùy chọn có thể vắng mặt.

Để xác thực, số dư, lỗi định vị và tỷ lệ thất bại, hãy dùng tham chiếu lỗi được chia sẻ. Thời hạn nộp có lẽ đã tạo một công việc; kiểm tra công việc đã có trước khi thử lại.

Lỗi và mã trạng thái · Khi nào cần thử lại · Giới hạn

Hướng dẫn từng bước một: Chọn và tinh luyện một tìm kiếm Google

Giá

Gói dịch vụĐơn giá sử dụngcho mỗi 1.000 yêu cầuĐăng kýBao gồm cả tín dụng mỗi thời gian thanh toán
Trả theo mức sử dụng1,00 US$Không có phí hàng thángNạp thêm khi cần
Micro0,80 US$49,00 US$ / tháng1.000 Tín dụng (50,00 US$ Tháng Ba API sử dụng) bao gồm
Starter0,65 US$199,00 US$ / tháng4.000 Tín dụng (200,00 US$ Tháng Ba API sử dụng) bao gồm
Pro0,60 US$499,00 US$ / tháng10.000 Tín dụng (500,00 US$ Tháng Ba API sử dụng) bao gồm
Scale0,50 US$999,00 US$ / tháng20.000 Tín dụng (1.000,00 US$ Tháng Ba API sử dụng) bao gồm
Business0,40 US$1.999,00 US$ / tháng40.000 Tín dụng (2.000,00 US$ Tháng Ba API sử dụng) bao gồm

Một gói tài khoản. Tín dụng dùng chung cho cả ba sản phẩm. Mức sử dụng được tín dụng trong gói chi trả sẽ không bị tính phí lần nữa.

Giá cả hiện tại và giới hạn kế hoạch