Felo API PlatformFelo API Platform
Alle Endpoints von DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Google Shopping Review-Aufgaben einstellen

Server:https://openapi.felo.ai
Client-Bibliotheken

DataForSEO

​

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

Google Shopping Review-Aufgaben einstellen

​

Stellt die Reviews eines Google Shopping-Produkts in die Warteschlange und gibt eine Aufgaben-id zurück. Identifizieren Sie das Produkt mit product_id plus gid oder data_docid aus einem Produktergebnis. Diese Familie ist durchgängig 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_merchant_google_reviews_fetch ab.

Preisreferenz

  • Abrechnung: Gemeldete Antwortkosten.
  • Referenzschätzung pro Anfrage: USD 0.012.
  • Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf bereits abgerechnete Kundenbeträge anwenden.

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

Body
erforderlich
application/json
  • Typ: array object[]
    • Typ: object
      • gid
        Typ: string
        erforderlich

        Globale Produktkennung bei Google Shopping. Pflichtfeld. Für optimale Ergebnisse empfehlen wir, gid zusammen mit data_docid und product_id anzugeben; diesen Wert für ein bestimmtes Produkt erhalten Sie durch eine separate Anfrage an den Google Shopping Products-Endpunkt. Beispiel: 4702526954592161872. Weitere Informationen zum Parameter finden Sie in dieser Help-Center-Anleitung.

      • data_docid
        Typ: string

        Eindeutige Kennung des SERP-Datenelements. Optionales Feld. Für optimale Ergebnisse empfehlen wir, data_docid zusammen mit product_id und gid anzugeben; diesen Wert für ein bestimmtes Element erhalten Sie durch eine separate Anfrage an den Google Shopping Products-Endpunkt. Beispiel: 13071766526042404278

      • depth
        Typ: integer

        Parsing-Tiefe. Optionales Feld. Anzahl der Bewertungen in der SERP; wir empfehlen dringend, die Parsing-Tiefe in Vielfachen von zehn festzulegen, da unser System zehn Bewertungen am Stück verarbeitet; Maximalwert: 8000. Standardwert: 10. Ihr Konto wird für jede SERP abgerechnet, die bis zu 10 Ergebnisse enthält; eine Tiefe über 10 kann zu zusätzlichen Kosten führen, wenn die Suchmaschine mehr als 10 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 ihren language_code-Parametern erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/merchant/google/languages. Beispiel: en_GB

      • 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 ihren language_name-Parametern erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/merchant/google/languages. Beispiel: English (United Kingdom)

      • location_code
        Typ: integer

        Standortcode der Suchmaschine. Pflichtfeld, wenn Sie location_name oder location_coordinate nicht angeben. Wenn Sie dieses Feld verwenden, müssen Sie location_name oder location_coordinate nicht angeben. Die Liste der verfügbaren Standorte mit ihren location_code-Parametern erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/merchant/google/locations. Beispiel: 9045969

      • location_coordinate
        Typ: string

        GPS-Koordinaten eines Standorts. Pflichtfeld, wenn Sie location_name oder location_code nicht angeben. Wenn Sie dieses Feld verwenden, müssen Sie location_name oder location_code nicht angeben. Der Parameter location_coordinate muss im Format „latitude,longitude,radius“ angegeben werden. Die maximale Anzahl der Nachkommastellen für „latitude“ und „longitude“: 7. Der Mindestwert für „radius“: 199.9. Beispiel: 53.476225,-2.243572,200

      • location_name
        Typ: string

        Vollständiger Name des Suchmaschinenstandorts. Pflichtfeld, wenn Sie location_code oder location_coordinate nicht angeben. Wenn Sie dieses Feld verwenden, müssen Sie location_code oder location_coordinate nicht angeben. Die Liste der verfügbaren Standorte mit ihren location_name-Parametern erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/merchant/google/locations. Beispiel: HA1,England,United Kingdom

      • pingback_url
        Typ: string

        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. Weitere Informationen finden Sie in unserem Help Center.

      • postback_data
        Typ: string

        postback_url-Datentyp Optionales Feld Entspricht dem Datentyp, der an Ihren Server gesendet wird Mögliche Werte: advanced

      • postback_url
        Typ: string

        URL zum Senden von Aufgabenergebnissen 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. Weitere Informationen finden Sie in unserem Help Center.

      • priority
        Typ: integer

        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.

      • product_id
        Typ: string

        Eindeutiger Produktbezeichner bei Google Shopping Optionales Feld Wir empfehlen, product_id zusammen mit data_docid und gid anzugeben, um optimale Ergebnisse zu erzielen; diesen Wert erhalten Sie für ein bestimmtes Produkt durch eine separate Anfrage an den Endpunkt Google Shopping Products Beispiel: 4485466949985702538 Weitere Informationen zum Parameter finden Sie in dieser Hilfe-Center-Anleitung

      • se_domain
        Typ: string

        Suchmaschinen-Domain Optionales Feld Wir wählen die passende Suchmaschinen-Domain automatisch anhand des von Ihnen angegebenen Standorts und der Sprache aus. Sie können in diesem Feld jedoch eine benutzerdefinierte Suchmaschinen-Domain festlegen. Beispiel: google.co.uk, google.com.au, google.de usw.

      • tag
        Typ: string

        Benutzerdefinierte Aufgaben-ID. Optionales Feld. Das Zeichenlimit beträgt 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.

      Leeres Objekt
      Leeres Objekt
Antworten
  • 200
    Typ: object

    Erfolgreiche Antwort

    • cost
      Typ: number

      Gesamtkosten der Aufgaben in USD

    • status_code
      Typ: integer

      Allgemeiner Statuscode. Die vollständige Liste der Antwortcodes finden Sie hier. Hinweis: Wir empfehlen dringend, ein geeignetes System zur Behandlung zugehöriger Ausnahme- oder Fehlerbedingungen zu entwickeln.

    • status_message
      Typ: string

      Allgemeine Informationsmeldung. Die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier.

    • tasks
      Typ: array string[]

      Array der Aufgaben

    • tasks_count
      Typ: integer

      Die Anzahl der Aufgaben im tasksarray

    • tasks_error
      Typ: integer

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

    • tasks.cost
      Typ: number

      Kosten der Aufgabe in USD

    • tasks.data
      Typ: object

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

    • tasks.id
      Typ: string

      Eindeutiger Aufgabenbezeichner in unserem System im Format Universally unique identifier (UUID)

    • tasks.path
      Typ: array string[]

      URL-Pfad

    • tasks.result
      Typ: array string[]

      Array von Ergebnissen. In diesem Fall ist der Wert null

    • tasks.result_count
      Typ: integer

      Anzahl der Elemente im Ergebnis-Array

    • tasks.status_code
      Typ: integer

      Von DataForSEO generierter Statuscode der Aufgabe; kann im folgenden Bereich liegen: 10000-60000

    • tasks.status_message
      Typ: string

      Informationsmeldung zur Aufgabe

    • tasks.time
      Typ: string

      Ausführungszeit in Sekunden

    • time
      Typ: string

      Ausführungszeit in Sekunden

    • version
      Typ: string

      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
Request Example for post/v1/beta/dataforseo/merchant/google/reviews/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/google/reviews/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {},
  {}
]'
{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks_count": 1,
  "tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks.id": "string",
  "tasks.status_code": 1,
  "tasks.status_message": "string",
  "tasks.time": "string",
  "tasks.cost": 1,
  "tasks.result_count": 1,
  "tasks.path": [
    "string"
  ],
  "tasks.data": {},
  "tasks.result": [
    "string"
  ]
}
Setting Google Shopping Reviews Tasks