مثال على البدء السريع

إليك نموذج استعلام ProductPerformanceView التي تُرجع أداء حسابك على مدار آخر 30 يومًا، مقسمة حسب "marketingMethod" و"offerId" يمكنك تجربة هذا المثال السريع للحصول على على دراية بواجهة Merchant Reporting API

يجب الاطّلاع على الأداء والإحصاءات الدور لاسترداد هذا التقرير. يمكنك الاطّلاع على متطلبات المزيد من التفاصيل.

لتقديم الطلب، يُرجى تمرير طلب Merchant Center التالي: لغة إلى العبارة accounts.reports.search :

SELECT
  marketingMethod,
  offerId,
  impressions,
  clicks,
  clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2020-11-01' AND '2020-11-30'

عنوان URL لطلب HTTP

يتألف الطلب من طلب HTTP POST لخادم واجهة برمجة التطبيقات لإعداد التقارير Merchant Center على عنوان URL التالي:

https://merchantapi.googleapis.com/reports/v1beta/accounts/parent/reports:search

إكمال نموذج طلب HTTP

في ما يلي مثال كامل يعرض تعريف التقرير المضمّن داخل طلب HTTP POST:

POST /reports/v1beta/accounts/parent/reports:search HTTP/1.1
Host: merchantapi.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer

Parameters:
{
  "query" : "SELECT
              marketingMethod,
              offerId,
              impressions,
              clicks,
              clickThroughRate
            FROM ProductPerformanceView
            WHERE date BETWEEN '2020-11-01' AND '2020-11-30'"
}

إليك نموذج الرد:

{
  "results": [
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12345",
        "clicks": "38",
        "impressions": "1038",
        "clickThroughRate": "0.3661"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12346",
        "clicks": "126",
        "impressions": "1126",
        "clickThroughRate": "0.1119"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12346",
        "clicks": "26",
        "impressions": "526",
        "clickThroughRate": "0.0494"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12347",
        "clicks": "227",
        "impressions": "1227",
        "clickThroughRate": "0.1850"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12347",
        "clicks": "12",
        "impressions": "512",
        "clickThroughRate": "0.0234"
      }
    }
  ]
}