v0.2.0-beta

OpenAPI 3.1.0

Aufgaben für Google-App-Reviews einstellen

Felo API Support

MIT

Server

https://openapi.felo.ai

Client-Bibliotheken

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operationen

post/v1/beta/dataforseo/app_data/google/app_reviews/task_post

Aufgaben für Google-App-Reviews einstellen

Stellt die Bewertungen einer Google-Play-App anhand von app_id in die Warteschlange und gibt eine Aufgaben-id zurück. depth legt fest, wie viele gesammelt werden. Asynchron: submit gibt eine Aufgaben-id in tasks[0].id zurück, und das Fetch-Tool liefert das Ergebnis, sobald es bereit ist. Rufen Sie mit get_dataforseo_app_google_app_reviews_fetch ab.

Preisreferenz

Abrechnung: Gemeldete Antwortkosten.
Referenzschätzung pro Anfrage: USD 0.012.
Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf einen bereits abgerechneten Kundenbetrag anwenden.

Nur Referenzmetadaten, kein Kontenangebot, kein garantierter Preis und keine Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.

Body

application/json

Typ: array (object | null)[]
- app_id
  Typ: string
  
  ID der App
  Pflichtfeld
  ID der mobilen Anwendung in Google Play;
  Die ID finden Sie in der URL jeder in Google Play gelisteten App;
  Beispiel:
  https://play.google.com/store/apps/details?id=org.telegram.messenger
- depth
  Typ: integer | null
  
  Parsing-Tiefe
  optionales Feld
  Anzahl der Bewertungen, die in der API-Antwort zurückgegeben werden;
  Wir empfehlen dringend, die Parsing-Tiefe in Vielfachen von 150 festzulegen, da unser System 150 Bewertungen am Stück verarbeitet;
  Standardwert: 150;
  Maximalwert: 100000;
  Ihr Konto wird für jede SERP abgerechnet, die bis zu 150 Ergebnisse enthält;
  Eine Tiefe über 150 kann zu zusätzlichen Kosten führen, wenn die Suchmaschine mehr als 150 Ergebnisse zurückgibt;
  Die Kosten lassen sich auf der Seite Pricing berechnen.
- language_code
  Typ: string
  
  Sprachcode der Suchmaschine
  Pflichtfeld, wenn Sie language_name nicht angeben
  Wenn Sie dieses Feld verwenden, müssen Sie language_name nicht angeben
  Die Liste der verfügbaren Sprachen mit ihrem language_code erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/app_data/google/languages
  Beispiel:
  en
- language_name
  Typ: string
  
  Vollständiger Name der Suchmaschinensprache
  Pflichtfeld, wenn Sie language_code nicht angeben
  Wenn Sie dieses Feld verwenden, müssen Sie language_code nicht angeben
  Die Liste der verfügbaren Sprachen mit language_name erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/app_data/google/languages
  Beispiel:
  English
- location_code
  Typ: integer
  
  Standortcode der Suchmaschine
  Pflichtfeld, wenn Sie location_name nicht angeben
  Wenn Sie dieses Feld verwenden, müssen Sie location_name nicht angeben
  Die Liste der verfügbaren Standorte der Suchmaschine mit ihrem location_code erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/app_data/google/locations
  Beispiel:
  9061121
- location_name
  Typ: string
  
  Vollständiger Name des Suchmaschinenstandorts
  Pflichtfeld, wenn Sie location_code nicht angeben
  Wenn Sie dieses Feld verwenden, müssen Sie location_code nicht angeben
  Die Liste der verfügbaren Standorte der Suchmaschine mit ihrem location_name erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/app_data/google/locations
  Beispiel:
  West Los Angeles,California,United States
- pingback_url
  Typ: string | null
  
  Benachrichtigungs-URL für eine abgeschlossene Aufgabe
  optionales Feld
  Wenn eine Aufgabe abgeschlossen ist, benachrichtigen wir Sie per GET-Anfrage an die von Ihnen angegebene URL
  Sie können die Zeichenfolge „$id“ als $id-Variable und „$tag“ als urlencodierte $tag-Variable verwenden. Wir setzen die erforderlichen Werte vor dem Senden der Anfrage.
  Beispiel:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Hinweis: Sonderzeichen in pingback_url werden urlencodiert;
  u. a. wird das Zeichen # in %23 kodiert
- postback_data
  Typ: string
  
  postback_url-Datentyp
  Pflichtfeld, wenn Sie postback_url angeben
  entspricht dem Datentyp, der an Ihren Server gesendet wird
  mögliche Werte:
  advanced, html
- postback_url
  Typ: string | null
  
  URL zum Senden der Aufgabenergebnisse
  optionales Feld
  Sobald die Aufgabe abgeschlossen ist, senden wir eine POST-Anfrage mit den im gzip-Format komprimierten Ergebnissen an die von Ihnen angegebene postback_url
  Sie können die Zeichenfolge „$id“ als $id-Variable und „$tag“ als urlencodierte $tag-Variable verwenden. Wir setzen die erforderlichen Werte vor dem Senden der Anfrage.
  Beispiel:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Hinweis: Sonderzeichen in postback_url werden urlencodiert;
  u. a. wird das Zeichen # in %23 kodiert
- priority
  Typ: integer | null
  
  Aufgabenpriorität
  optionales Feld
  kann folgende Werte annehmen:
  1 – normale Ausführungspriorität (standardmäßig gesetzt)
  2 – hohe Ausführungspriorität. Für Aufgaben mit hoher Ausführungspriorität wird zusätzlich berechnet.
  Die Kosten lassen sich auf der Seite Pricing berechnen.
- rating
  Typ: integer | null
  
  Bewertungen nach Sternen filtern
  optionales Feld
  Mit diesem Feld können Sie die Ergebnisse filtern;
  mögliche Filterarten:
  5 — nur Bewertungen mit fünf Sternen liefern;
  4 — nur Bewertungen mit vier Sternen liefern;
  3 — nur Bewertungen mit drei Sternen liefern;
  2 — nur Bewertungen mit zwei Sternen liefern;
  1 — nur Bewertungen mit einem Stern liefern;
  standardmäßig liefert die API alle Bewertungen unabhängig von der Anzahl der Sterne
- sort_by
  Typ: string | null
  
  Sortierparameter für Ergebnisse
  optionales Feld
  Sie können dieses Feld verwenden, um die Ergebnisse zu sortieren;
  mögliche Sortierarten:
  newest — sortiert nach den neuesten Bewertungen;
  most_relevant — sortiert nach den relevantesten Bewertungen;
  Standardregel: most_relevant
- tag
  Typ: string | null
  
  Benutzerdefinierte Aufgaben-ID
  Optionales Feld
  Zeichenlimit: 255
  Mit diesem Parameter können Sie die Aufgabe identifizieren und dem Ergebnis zuordnen
  Den angegebenen Wert tag finden Sie im data-Objekt der Antwort

Antworten

200
Typ: object | null · Response36Afe1097B20_AppDataGoogleAppReviewsTaskPostResponseInfo
cost
Typ: number | null Format: double

Gesamtkosten der Aufgaben in USD

status_code
Typ: integer | null

allgemeiner Statuscode die vollständige Liste der Antwortcodes finden Sie hier

status_message
Typ: string | null

allgemeine Informationsmeldung die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier

tasks
Typ: array (object | null)[] | null

Array von Aufgaben

Typ: object | null · Response36Afe1097B20_AppDataGoogleAppReviewsTaskPostTaskInfo
cost
Typ: number | null Format: double

Gesamtkosten der Aufgaben in USD

data
Typ: object | null

Enthält dieselben Parameter, die Sie in der POST-Anfrage angegeben haben

propertyName
Typ: object | null
id
Typ: string | null

Aufgaben-ID eindeutige Aufgaben-ID in unserem System im UUID-Format

path
Typ: array (string | null)[] | null

URL-Pfad

result
Typ: object | null

Array von Ergebnissen
in diesem Fall ist der Wert null

result_count
Typ: integer | null Format: int64

Anzahl der Elemente im Ergebnis-Array

status_code
Typ: integer | null

Statuscode der Aufgabe von DataForSEO erzeugt, kann im folgenden Bereich liegen: 10000-60000 die vollständige Liste der Antwortcodes finden Sie hier

status_message
Typ: string | null

Informationsmeldung der Aufgabe die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier

time
Typ: string | null

Ausführungszeit in Sekunden

tasks_count
Typ: integer | null Format: int64

Die Anzahl der Aufgaben im tasks-Array

tasks_error
Typ: integer | null Format: int64

Die Anzahl der Aufgaben im tasks-Array, die mit einem Fehler zurückgegeben wurden

time
Typ: string | null

Gesamtausführungszeit, Sekunden

version
Typ: string | null

Die aktuelle Version der API
application/json
400

Die Anfrage konnte nicht verarbeitet werden. Prüfen Sie die Anfrageparameter.
401

Ein gültiger Felo-API-Schlüssel ist erforderlich.
402

Die Anfrage kann nicht fortgesetzt werden, da eine Abrechnungsvoraussetzung nicht erfüllt ist.
403

Das Konto ist für diesen Vorgang nicht berechtigt.
429

Ein Anfrage- oder Ausgabenlimit wurde erreicht.
502

Der Dienst konnte die Anfrage nicht abschließen.
503

Die API oder der Abrechnungsdienst ist vorübergehend nicht verfügbar.
504

Beim Verarbeiten der Anfrage ist eine Zeitüberschreitung aufgetreten.
default

Fehlerantwort; Upstream-Passthrough-Antworten können Anbieterformate verwenden

application/json

post/v1/beta/dataforseo/app_data/google/app_reviews/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/app_data/google/app_reviews/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "app_id": "org.telegram.messenger",
    "location_code": 2840,
    "language_code": "en",
    "depth": 150
  }
]'

Schema anzeigen

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": null
    }
  ]
}

Erfolgreicher Vorgang

Aufgaben für Google-App-Reviews einstellen

AuthentifizierungRequired

DataForSEO

Aufgaben für Google-App-Reviews einstellen

Preisreferenz