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

في ما يلي نموذج طلب بحث عن ProductPerformanceView يعرض أداء حسابك خلال آخر 30 يومًا، مقسّمًا حسب marketingMethod وofferId. يمكنك تجربة هذا المثال السريع للتعرّف على واجهة برمجة تطبيقات Merchant Reports API.

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

ملاحظة: يعرض هذا الدليل طلب HTTP الأساسي كأداة تعليمية، ولكننا ننصحك باستخدام إحدى مكتبات العملاء لإرسال طلباتك.

لتقديم الطلب، مرِّر عبارة لغة طلب البحث في 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

يتألف الطلب من طريقة POST لبروتوكول HTTP إلى خادم واجهة برمجة تطبيقات تقارير التجار على عنوان 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"
      }
    }
  ]
}