Dokumentasi API

Integrasikan DataBridge.id dengan aplikasi Anda

Mulai Cepat - Google Sheets Add-on

1. Install Add-on

Install DataBridge.id add-on dari Google Workspace Marketplace

2. Login & Connect

3. Pull Data

Pilih platform, metrik, dan tarik data langsung ke Google Sheets

Contoh Penggunaan Add-on

1. Buka Google Sheets → Extensions → DataBridge.id

2. Klik "Login" → Browser terbuka ke databridge.id

3. Login ke dashboard → Kembali ke Sheets

4. Pilih Meta Ads → Pilih akun → Pilih impressions, clicks

5. Klik "Pull Data" → Data muncul di sheet

Google Sheets Add-on API

POST/api/addon/validate

Validasi autentikasi pengguna untuk Google Sheets add-on

POST/api/addon/user-info

Dapatkan informasi profil pengguna untuk add-on

POST/api/addon/connections

Daftar platform dan akun yang terhubung

POST/api/addon/metrics

Dapatkan metrik yang tersedia untuk platform tertentu

POST/api/addon/dimensions

Dapatkan dimensi yang tersedia untuk platform tertentu

POST/api/addon/report

Ambil data laporan berdasarkan konfigurasi

Fitur

Data Real-time

Dapatkan pembaruan data langsung dari semua sumber yang terhubung

CDN Global

Respons API cepat dari jaringan global kami

Keamanan Enterprise

Enkripsi dan protokol keamanan enterprise-grade

Autentikasi Add-on

OAuth Flow untuk Google Sheets

Add-on menggunakan OAuth 2.0 flow untuk autentikasi aman:

1. User klik "Login" di add-on

2. Browser buka databridge.id/oauth/google-sheets

3. User login ke DataBridge.id dashboard

4. Add-on menerima session token

5. Semua API calls menggunakan session token

Rate Limits

Validasi100x/menit per user

Data Pull50x/jam per user

AnalyticsTak terbatas

Contoh API Request & Response

1. Validasi User (/api/addon/validate)

Request

POST /api/addon/validate
Content-Type: application/json

{
  "email": "user@example.com",
  "source": "google-sheets-addon"
}

Response

{
  "authenticated": true,
  "user": {
    "id": "user-uuid",
    "email": "user@example.com",
    "name": "John Doe"
  },
  "sessionToken": "session-token-here"
}

2. Get Connected Platforms (/api/addon/connections)

Request

POST /api/addon/connections
Content-Type: application/json

{
  "email": "user@example.com",
  "source": "google-sheets-addon"
}

Response

{
  "platforms": [
    {
      "platform": "meta",
      "name": "Meta Ads",
      "accounts": [
        {
          "id": "act_123456789",
          "name": "My Facebook Page",
          "status": "active"
        }
      ]
    },
    {
      "platform": "google",
      "name": "Google Ads",
      "accounts": [
        {
          "id": "123-456-7890",
          "name": "My Google Ads Account",
          "status": "active"
        }
      ]
    }
  ]
}

3. Pull Report Data (/api/addon/report)

Request

POST /api/addon/report
Content-Type: application/json

{
  "email": "user@example.com",
  "platform": "meta",
  "accountId": "act_123456789",
  "metrics": ["impressions", "clicks", "spend"],
  "dimensions": ["campaign_name", "adset_name"],
  "dateRange": {
    "start": "2024-01-01",
    "end": "2024-01-31"
  },
  "filters": []
}

Response

{
  "data": [
    {
      "campaign_name": "Summer Sale 2024",
      "adset_name": "Lookalike Audience",
      "impressions": 15420,
      "clicks": 234,
      "spend": 45.67
    },
    {
      "campaign_name": "Brand Awareness",
      "adset_name": "Interests: Tech",
      "impressions": 8920,
      "clicks": 156,
      "spend": 23.45
    }
  ],
  "summary": {
    "totalRows": 2,
    "dateRange": "2024-01-01 to 2024-01-31"
  }
}

Butuh Bantuan?

Tim dukungan developer kami siap membantu Anda mengintegrasikan dengan sukses.

Hubungi Dukungan Lihat Dashboard