# Metrik Aplikasi Pukal Google Play Langsung

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/dataforseo_labs/google/bulk_app_metrics/live`

**Tags:** DataForSEO

Penilaian, ulasan dan anggaran pemasangan untuk banyak aplikasi Google Play dalam satu panggilan. Endpoint ini tiada parameter had, tetapi dicaj setiap panggilan dan bukan setiap item, jadi hantar keseluruhan senarai sekali gus. Dibungkus dalam sampul DataForSEO: data dalam `tasks[0].result`, hasil dalam `tasks[0].status_code` - permintaan yang ditolak masih memulangkan HTTP 200. Harga setiap panggilan, jadi inilah cara menyaring senarai aplikasi sebelum berbelanja panggilan setiap aplikasi. Kembar Apple: `post_dataforseo_labs_apple_bulk_app_metrics_live`.

### Rujukan harga

- Pemeteran: kos respons yang dilaporkan.
- Anggaran rujukan setiap permintaan: USD 0,1356.
- Pengganda rujukan pelanggan: 1,0. Jangan gunakannya semula pada amaun pelanggan yang telah diselesaikan.

Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "app_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "<em>id aplikasi</em><br><strong>medan wajib</strong><br>ID aplikasi mudah alih di Google Play;<br>anda boleh menemui ID dalam URL setiap aplikasi yang disenaraikan di Google Play;<br>contoh:<br>dalam URL <code>https://play.google.com/store/apps/details?id=org.telegram.messenger</code><br>id ialah <code>org.telegram.messenger</code>;<br>bilangan maksimum ID yang boleh anda tetapkan dalam medan ini ialah <code>1000</code>"
          },
          "location_name": {
            "type": "string",
            "description": "<em>nama penuh lokasi</em><br><strong>medan wajib jika anda tidak menentukan</strong> <code>location_code</code><br><strong>Nota:</strong> anda perlu menentukan <code>location_name</code> atau <code>location_code</code><br>anda boleh mendapatkan senarai lokasi tersedia bersama <code>location_name</code> masing-masing dengan membuat permintaan berasingan ke <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code>;<br><strong>Nota:</strong> endpoint ini pada masa ini hanya menyokong lokasi US;<br>contoh:<br><code class=\"long-string\">United States</code>"
          },
          "location_code": {
            "type": "integer",
            "description": "<em>kod lokasi</em><br><strong>medan wajib jika anda tidak menentukan</strong> <code>location_name</code><br><strong>Nota:</strong> anda perlu menentukan <code>location_name</code> atau <code>location_code</code><br>anda boleh mendapatkan senarai lokasi tersedia bersama <code>location_code</code> masing-masing dengan membuat permintaan berasingan ke <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code>;<br><strong>Nota:</strong> endpoint ini pada masa ini hanya menyokong lokasi US<br>contoh:<br><code class=\"long-string\">2840</code>"
          },
          "language_name": {
            "type": "string",
            "description": "<em>nama penuh bahasa</em><br><strong>medan wajib jika anda tidak menentukan</strong> <code>language_code</code><br><strong>Nota:</strong> anda perlu menentukan <code>language_name</code> atau <code>language_code</code><br>anda boleh mendapatkan senarai bahasa tersedia bersama <code>language_name</code> masing-masing dengan membuat permintaan berasingan ke <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code>;<br><strong>Nota:</strong> endpoint ini pada masa ini hanya menyokong bahasa English;<br>contoh:<br><code class=\"long-string\">English</code>"
          },
          "language_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>kod bahasa</em><br><strong>medan wajib jika anda tidak menentukan</strong> <code>language_name</code><br><strong>Nota:</strong> anda perlu menentukan <code>language_name</code> atau <code>language_code</code><br>anda boleh mendapatkan senarai bahasa tersedia bersama <code>language_code</code> masing-masing dengan membuat permintaan berasingan ke <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code>;<br><strong>Nota:</strong> endpoint ini pada masa ini hanya menyokong bahasa English<br>contoh:<br><code class=\"long-string\">en</code>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>pengecam tugas yang ditentukan pengguna</em><br>medan pilihan<br><em>had aksara ialah 255</em><br>anda boleh menggunakan parameter ini untuk mengenal pasti tugas dan memadankannya dengan hasil<br>anda akan menemui nilai <code>tag</code> yang ditentukan dalam objek <code>data</code> respons"
          }
        },
        "example": [
          {
            "app_ids": [
              "org.telegram.messenger",
              "com.zhiliaoapp.musically"
            ],
            "language_name": "English",
            "location_code": 2840
          }
        ]
      }
    ]
  },
  "example": [
    {
      "app_ids": [
        "org.telegram.messenger",
        "com.zhiliaoapp.musically"
      ],
      "language_name": "English",
      "location_code": 2840
    }
  ]
}
```

## Responses

### 200 — Operasi berjaya

Headers:
- `X-Request-Id` (string) — Pengecam permintaan untuk disertakan semasa menghubungi sokongan Felo.

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleBulkAppMetricsLiveResponseInfo"
    }
  ]
}
```

### 400 — Permintaan tidak dapat diproses. Semak parameter permintaan.

### 401 — Kunci API Felo yang sah diperlukan.

### 402 — Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.

### 403 — Akaun tidak dibenarkan melakukan operasi ini.

### 429 — Had permintaan atau had perbelanjaan telah dicapai.

### 502 — Perkhidmatan tidak dapat menyelesaikan permintaan.

### 503 — API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.

### 504 — Perkhidmatan tamat masa semasa memproses permintaan.

### default — Respons ralat; respons passthrough huluan mungkin menggunakan format penyedia

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_AppMetricsInfo

`#/components/schemas/Response36Afe1097B20_AppMetricsInfo`

```json
{
  "type": "object",
  "properties": {
    "pos_1": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan SERP organik tempat produk menduduki #1</em>"
    },
    "pos_2_3": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan SERP organik tempat produk menduduki #2-3</em>"
    },
    "pos_4_10": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan SERP organik tempat produk menduduki #4-10</em>"
    },
    "pos_11_100": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan SERP organik tempat produk menduduki #11-100</em>"
    },
    "count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah SERP organik Amazon yang mengandungi produk</em>",
      "format": "int64"
    },
    "search_volume": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah volum carian kata kunci kedudukan produk dalam SERP organik</em>",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "versi semasa API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "kod status umum; anda boleh menemui senarai penuh kod respons di sini"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "jumlah masa pelaksanaan, saat"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "jumlah kos tugas, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "bilangan tugas dalam array tasks",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "bilangan tugas dalam array tasks yang dipulangkan dengan ralat",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "masa pelaksanaan, saat"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "jumlah kos tugas, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "bilangan elemen dalam array hasil",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "Laluan URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST"
    }
  }
}
```

### Response36Afe1097B20_DataforseoLabsGoogleBulkAppMetricsLiveResponseInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleBulkAppMetricsLiveResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleBulkAppMetricsLiveTaskInfo"
              }
            ]
          },
          "description": "<em>tatasusunan tugas</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_DataforseoLabsGoogleBulkAppMetricsLiveResultInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleBulkAppMetricsLiveResultInfo`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>jenis enjin carian</em>"
    },
    "location_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>kod lokasi dalam array POST</em>"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>kod bahasa dalam array POST</em>"
    },
    "total_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah hasil dalam pangkalan data kami yang berkaitan dengan permintaan anda</em>",
      "format": "int64"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan hasil yang dipulangkan dalam array <code>items</code></em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsleBulkAppMetricsLiveItem"
          }
        ]
      },
      "description": "<em>mengandungi data berkaitan metrik kedudukan aplikasi yang ditentukan"
    }
  }
}
```

### Response36Afe1097B20_DataforseoLabsGoogleBulkAppMetricsLiveTaskInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleBulkAppMetricsLiveTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleBulkAppMetricsLiveResultInfo"
              }
            ]
          },
          "description": "<em>tatasusunan hasil</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_DataforseoLabsleBulkAppMetricsLiveItem

`#/components/schemas/Response36Afe1097B20_DataforseoLabsleBulkAppMetricsLiveItem`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>jenis enjin carian</em>"
    },
    "app_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>id aplikasi dalam array POST</em>"
    },
    "metrics": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "$ref": "#/components/schemas/Response36Afe1097B20_AppMetricsInfo"
      },
      "description": "<em>metrik untuk kata kunci kedudukan aplikasi</em><br>data kedudukan yang berkaitan dengan kata kunci yang diduduki aplikasi yang diberikan di Google Play"
    }
  }
}
```
