# Google Shopping Yorum Görevlerini Oluşturma

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/merchant/google/reviews/task_post`

**Tags:** DataForSEO

Bir Google Shopping ürününün yorumlarını kuyruğa alır ve bir görev `id` değeri döndürür. Ürünü `product_id` ile ve ürünler sonucundan alınan `gid` veya `data_docid` ile tanımlayın. Bu ailenin tamamı eşzamansızdır: gönderim `tasks[0].id` içinde bir görev `id` değeri döndürür ve getirme aracı hazır olduğunda sonucu döndürür. `get_dataforseo_merchant_google_reviews_fetch` ile getirin.

### Fiyatlandırma referansı

- Ölçümlendirme: bildirilen yanıt maliyeti.
- Referans istek tahmini: USD 0.012.
- Referans müşteri çarpanı: 1.0. Kesinleşmiş müşteri tutarına yeniden uygulamayın.

Yalnızca referans üst verisidir; hesap teklifi, garantili fiyat veya harcama üst sınırı değildir. Kaynak kredileri Felo kredisi değildir. Nihai ücretler Felo faturalandırma kayıtlarını izler.

## 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: **yes**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "gid": {
        "type": "string",
        "description": "Google Shopping'deki genel ürün tanımlayıcısı. Zorunlu alan. En iyi sonuçlar için gid değerini data_docid ve product_id ile birlikte belirtmenizi öneririz; belirli bir ürün için bu değeri Google Shopping Products uç noktasına ayrı bir istek göndererek alabilirsiniz. Örnek: 4702526954592161872. Parametre hakkında daha fazla bilgi için bu yardım merkezi kılavuzuna bakın."
      },
      "product_id": {
        "type": "string",
        "description": "Google Shopping'de benzersiz ürün tanımlayıcısı isteğe bağlı alan optimum sonuçlar için product_id değerini data_docid ve gid ile birlikte belirtmenizi öneririz; bu değeri belirli bir ürün için Google Shopping Products uç noktasına ayrı bir istek göndererek alabilirsiniz örnek: 4485466949985702538 parametre hakkında daha fazla bilgi için bu yardım merkezi kılavuzuna bakın"
      },
      "data_docid": {
        "type": "string",
        "description": "SERP veri öğesinin benzersiz tanımlayıcısı. İsteğe bağlı alan. En iyi sonuçlar için data_docid değerini product_id ve gid ile birlikte belirtmenizi öneririz; belirli bir öğe için bu değeri Google Shopping Products uç noktasına ayrı bir istek göndererek alabilirsiniz. Örnek: 13071766526042404278."
      },
      "priority": {
        "type": "integer",
        "description": "görev önceliği isteğe bağlı alan şu değerleri alabilir: 1 – normal yürütme önceliği (varsayılan olarak ayarlanır) 2 – yüksek yürütme önceliği yüksek yürütme önceliğine sahip görevler için ek ücret alınır. maliyet fiyatlandırma sayfasında hesaplanabilir."
      },
      "location_name": {
        "type": "string",
        "description": "arama motoru konumunun tam adı. Belirtmezseniz zorunlu alan location_code veya location_coordinate. Bu alanı kullanırsanız location_code veya location_coordinate belirtmeniz gerekmez. Mevcut konumların listesini location_name parametreleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/merchant/google/locations. Örnek: HA1,England,United Kingdom."
      },
      "location_code": {
        "type": "integer",
        "description": "arama motoru konum kodu. Belirtmezseniz zorunlu alan location_name veya location_coordinate. Bu alanı kullanırsanız location_name veya location_coordinate belirtmeniz gerekmez. Mevcut konumların listesini location_code parametreleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/merchant/google/locations. Örnek: 9045969."
      },
      "location_coordinate": {
        "type": "string",
        "description": "bir konumun GPS koordinatları. Belirtmezseniz zorunlu alan location_name veya location_code. Bu alanı kullanırsanız location_name veya location_code belirtmeniz gerekmez. location_coordinate parametresi “latitude,longitude,radius” biçiminde belirtilmelidir. “latitude” ve “longitude” için maksimum ondalık basamak sayısı: 7. “radius” için minimum değer: 199.9. Örnek: 53.476225,-2.243572,200."
      },
      "language_name": {
        "type": "string",
        "description": "arama motoru dilinin tam adı. Belirtmezseniz zorunlu alan language_code. Bu alanı kullanırsanız language_code belirtmeniz gerekmez. Mevcut dillerin listesini language_name parametreleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/merchant/google/languages. Örnek: English (United Kingdom)."
      },
      "language_code": {
        "type": "string",
        "description": "arama motoru dil kodu. Belirtmezseniz zorunlu alan language_name. Bu alanı kullanırsanız language_name belirtmeniz gerekmez. Mevcut dillerin listesini language_code parametreleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/merchant/google/languages. Örnek: en_GB."
      },
      "se_domain": {
        "type": "string",
        "description": "arama motoru alan adı isteğe bağlı alan ilgili arama motoru alan adını belirttiğiniz konum ve dile göre otomatik olarak seçiyoruz ancak bu alanda özel bir arama motoru alan adı ayarlayabilirsiniz örnek: google.co.uk, google.com.au, google.de, vb."
      },
      "depth": {
        "type": "integer",
        "description": "ayrıştırma derinliği. İsteğe bağlı alan. SERP'teki inceleme sayısı; ayrıştırma derinliğini onun katları olarak ayarlamanızı kesinlikle öneririz, çünkü sistemimiz art arda on inceleme işler. Maksimum değer: 8000. Varsayılan değer: 10. Hesabınız 10 sonuca kadar içeren her SERP için faturalandırılır; derinliği 10'un üzerine ayarlamak, arama motoru 10'dan fazla sonuç döndürürse ek ücretlere yol açabilir. Maliyet Fiyatlandırma sayfasında hesaplanabilir."
      },
      "tag": {
        "type": "string",
        "description": "kullanıcı tanımlı görev tanımlayıcısı — isteğe bağlı alan. Karakter sınırı 255. Bu parametreyi görevi tanımlamak ve sonuçla eşleştirmek için kullanabilirsiniz. Belirtilen tag değerini yanıtın data nesnesinde bulacaksınız"
      },
      "postback_url": {
        "type": "string",
        "description": "görev sonuçlarını gönderme URL'si isteğe bağlı alan görev tamamlandığında, sonuçları gzip biçiminde sıkıştırılmış olarak belirttiğiniz postback_url adresine bir POST isteğiyle göndereceğiz ‘$id’ dizesini $id değişkeni olarak, ‘$tag’ dizesini URL kodlamalı $tag değişkeni olarak kullanabilirsiniz. İsteği göndermeden önce gerekli değerleri ayarlayacağız. örnek: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag Not: postback_url içindeki özel karakterler URL kodlamasına tabi tutulur; örneğin # karakteri %23 olarak kodlanır daha fazla bilgi için Yardım Merkezimizi ziyaret edin"
      },
      "postback_data": {
        "type": "string",
        "description": "postback_url veri türü isteğe bağlı alan sunucunuza gönderilecek veri türüne karşılık gelir olası değerler: advanced"
      },
      "pingback_url": {
        "type": "string",
        "description": "tamamlanan görevin bildirim URL'si isteğe bağlı alan görev tamamlandığında, belirttiğiniz URL'ye gönderilen bir GET isteğiyle sizi bilgilendireceğiz ‘$id’ dizesini $id değişkeni olarak, ‘$tag’ dizesini URL kodlamalı $tag değişkeni olarak kullanabilirsiniz. İsteği göndermeden önce gerekli değerleri ayarlayacağız. örnek: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag Not: pingback_url içindeki özel karakterler URL kodlamasına tabi tutulur; örneğin # karakteri %23 olarak kodlanır daha fazla bilgi için Yardım Merkezimizi ziyaret edin"
      }
    },
    "required": [
      "gid"
    ],
    "allOf": [
      {
        "anyOf": [
          {
            "required": [
              "location_name"
            ]
          },
          {
            "required": [
              "location_code"
            ]
          },
          {
            "required": [
              "location_coordinate"
            ]
          }
        ]
      },
      {
        "anyOf": [
          {
            "required": [
              "language_name"
            ]
          },
          {
            "required": [
              "language_code"
            ]
          }
        ]
      }
    ]
  }
}
```

## Responses

### 200 — Başarılı yanıt

Headers:
- `X-Request-Id` (string) — Felo desteğiyle iletişime geçerken belirtilecek istek tanımlayıcısı.

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "version": {
      "type": "string",
      "description": "API'nin geçerli sürümü"
    },
    "status_code": {
      "type": "integer",
      "description": "genel durum kodu. Yanıt kodlarının tam listesini burada bulabilirsiniz. Not: ilgili istisnai veya hata koşullarını işlemek için gerekli bir sistem tasarlamanızı kesinlikle öneririz"
    },
    "status_message": {
      "type": "string",
      "description": "genel bilgilendirme mesajı. Genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz"
    },
    "time": {
      "type": "string",
      "description": "yürütme süresi, saniye"
    },
    "cost": {
      "type": "number",
      "description": "toplam görev maliyeti, USD"
    },
    "tasks_count": {
      "type": "integer",
      "description": "tasks dizisindeki görev sayısı"
    },
    "tasks_error": {
      "type": "integer",
      "description": "tasks dizisinde hata ile dönen görev sayısı"
    },
    "tasks": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "görev dizisi"
    },
    "tasks.id": {
      "type": "string",
      "description": "sistemimizdeki benzersiz görev tanımlayıcısı evrensel olarak benzersiz tanımlayıcı (UUID) biçiminde"
    },
    "tasks.status_code": {
      "type": "integer",
      "description": "DataForSEO tarafından oluşturulan görev durum kodu; şu aralıkta olabilir: 10000-60000"
    },
    "tasks.status_message": {
      "type": "string",
      "description": "görevin bilgilendirici mesajı"
    },
    "tasks.time": {
      "type": "string",
      "description": "yürütme süresi, saniye"
    },
    "tasks.cost": {
      "type": "number",
      "description": "görevin maliyeti, USD"
    },
    "tasks.result_count": {
      "type": "integer",
      "description": "result dizisindeki öğe sayısı"
    },
    "tasks.path": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "URL yolu"
    },
    "tasks.data": {
      "type": "object",
      "description": "POST isteğinde belirttiğiniz parametrelerin aynısını içerir"
    },
    "tasks.result": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "sonuç dizisi; bu durumda değer null olur"
    }
  }
}
```

### 400 — İstek işlenemedi. İstek parametrelerini kontrol edin.

### 401 — Geçerli bir Felo API anahtarı gerekir.

### 402 — Faturalandırma koşulu karşılanmadığı için istek devam edemiyor.

### 403 — Hesabın bu işlemi gerçekleştirme izni yok.

### 429 — İstek veya harcama sınırına ulaşıldı.

### 502 — Hizmet isteği tamamlayamadı.

### 503 — API veya faturalandırma hizmeti geçici olarak kullanılamıyor.

### 504 — İstek işlenirken hizmet zaman aşımına uğradı.

### default — Hata yanıtı; upstream sağlayıcıdan doğrudan aktarılan yanıtlar sağlayıcı biçimlerini kullanabilir

**application/json**

Schema:

```json
{}
```
