البدء مع API

تتيح واجهة Gloriads API لأدواتك الخاصة، سواء أكانت جدول بيانات أم برنامجًا نصيًا أم أداة أتمتة، قراءة حسابك.

وهي للقراءة فقط. فالمفتاح يقرأ حسابك ولا يغيّر شيئًا. والـ API مشمولة في كل الباقات وخلال الفترة التجريبية المجانية.

ولسؤال مساعد ذكاء اصطناعي عن حسابك، لا تحتاج إلى أي مفتاح: راجع ربط مساعد ذكاء اصطناعي.

1. أنشئ مفتاحًا

الإعدادات ← API ← إنشاء مفتاح. سمِّه باسم الأداة التي ستستخدمه، ثم انسخ المفتاح. يبدأ المفتاح بـ key_live_ ولا يُعرض إلا مرة واحدة.

عدد المفاتيح التي يمكنك الاحتفاظ بها وكيفية إبطال أحدها: المصادقة ومفاتيح API.

2. نفّذ أول استدعاء

يُرسَل كل طلب إلى https://gloriads.com/api/v1 ويحمل مفتاحك في الترويسة Authorization:

curl https://gloriads.com/api/v1/account \
  -H "Authorization: Bearer YOUR_API_KEY"

تثبت /account أن المفتاح يعمل، وتصف الحساب الذي ينتمي إليه، وتذكر حتى أي يوم تصل أرقام Amazon Ads الخاصة بك:

{
  "is_demo": false,
  "subscription": { "status": "active" },
  "api_key": {
    "name": "My script",
    "start": "key_live_ab12",
    "scopes": ["read"],
    "created_at": "2026-09-15T07:55:00.000Z",
    "last_used_at": null
  },
  "connected_app": null,
  "amazon_ads": {
    "connection": "connected",
    "marketplaces": 3,
    "performance_data": {
      "currency": "USD",
      "first_date": "2021-03-01",
      "last_date": "2026-10-09",
      "synced_at": "2026-10-10T06:12:00.000Z",
      "is_syncing": false,
      "history_complete": true
    }
  }
}

إذا كانت قيمة connection هي error، فأعد ربط Amazon Ads من الإعدادات ← Amazon Ads: إذ تتوقف الأرقام عن التحديث حتى تفعل ذلك.

3. استكشف كل نقاط النهاية

أداؤك مقارنةً بفترة سابقة، ومنتجاتك، وحملات البث التلفزيوني، وحملاتك مع كلماتها الرئيسية وإعلاناتها، وقواعدك، وكل ما فعلته Gloriads على Amazon: تسرد صفحة ما تقرؤه الـ API كل نقطة نهاية مع مثال. ويعرض مرجع API كل معامل واستجابة، مع زر Try it لتجربتها.

الحدود

60 طلبًا في الدقيقة و10,000 طلب في اليوم لكل حساب. وعند تجاوز أي منهما، تجيب الـ API بالرمز 429 مع الترويسة Retry-After: راجع الحدود والأخطاء.