Felo API PlatformFelo API Platform
Tüm DataForSEO endpoint'leri
v0.2.0-beta
OpenAPI 3.1.0

Google Shopping Ürün Bilgisi Görevlerini Oluşturma

Felo API Support
MIT
Sunucu:https://openapi.felo.ai
İstemci Kitaplıkları
Shell Curl

DataForSEO

​

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

DataForSEO İşlemler

Google Shopping Ürün Bilgisi Görevlerini Oluşturma

​

Belirli bir Google Shopping ürününün aranmasını kuyruğa alır ve bir görev id değeri döndürür. Ürünü product_id ile ve get_dataforseo_merchant_google_products_fetch 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_product_info_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.

Gövde
application/json
  • Tür: array (object | null)[]
    • data_docid
      Tür: string

      SERP veri öğesinin benzersiz tanımlayıcısı
      product_id veya gid belirtilmezse zorunlu 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

    • gid
      Tür: string

      Google Shopping'deki genel ürün tanımlayıcısı
      product_id veya data_docid belirtilmezse zorunlu alan
      en iyi sonuçlar için gid değerini product_id ve data_docid 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

    • language_code
      Tür: string

      dil kodu
      belirtmezseniz zorunlu alan language_name
      bu alanı kullanırsanız language_name belirtmeniz gerekmez
      mevcut Google Shopping dillerinin listesini language_code değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/merchant/google/languages
      örnek:
      en

    • language_name
      Tür: string

      dilin tam adı
      belirtmezseniz zorunlu alan language_code
      bu alanı kullanırsanız language_code belirtmeniz gerekmez
      mevcut Google Shopping dillerinin listesini language_name değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/merchant/google/languages
      örnek:
      English

    • location_code
      Tür: integer

      konum kodu
      belirtmezseniz zorunlu alan location_name veya location_coordinate
      bu alanı kullanırsanız location_name veya location_coordinate belirtmeniz gerekmez
      mevcut Google Shopping konumlarının listesini location_code değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/merchant/google/locations
      örnek:
      2840

    • location_coordinate
      Tür: string

      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

    • location_name
      Tür: string

      konumun tam adı
      belirtmezseniz zorunlu alan location_code veya location_coordinate
      bu alanı kullanırsanız location_code veya location_coordinate belirtmeniz gerekmez
      mevcut Google Shopping konumlarının listesini location_name değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/merchant/google/locations
      örnek:
      London,England,United Kingdom

    • pingback_url
      Tür: string | null

      tamamlanan görevin bildirim URL'si
      isteğe bağlı alan
      görev tamamlandığında belirttiğiniz URL'ye gönderilen GET isteğiyle sizi bilgilendireceğiz
      ‘$id’ dizesini $id değişkeni, ‘$tag’ dizesini ise URL kodlu $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 kodlanır;
      yani, # karakteri %23 olarak kodlanır

      daha fazla bilgi için Yardım Merkezimize bakın

    • postback_data
      Tür: string | null

      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

    • postback_url
      Tür: string | null

      görev sonuçlarını göndermek için URL
      isteğe bağlı alan
      görev tamamlandığında sonuçlarını gzip biçiminde sıkıştırarak belirttiğiniz postback_url adresine POST isteğiyle göndereceğiz
      ‘$id’ dizesini $id değişkeni, ‘$tag’ dizesini ise URL kodlu $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 kodlanır;
      yani, # karakteri %23 olarak kodlanır

      daha fazla bilgi için Yardım Merkezimize bakın

    • priority
      Tür: integer | null

      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.

    • product_id
      Tür: string

      Google Shopping'deki benzersiz ürün tanımlayıcısı
      data_docid veya gid belirtilmezse zorunlu alan
      en iyi sonuçlar için product_id değerini data_docid ve gid 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:
      4485466949985702538
      parametre hakkında daha fazla bilgi için bu yardım merkezi kılavuzuna bakın

    • se_domain
      Tür: string | null

      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çeriz
      ancak bu alanda özel bir arama motoru alan adı ayarlayabilirsiniz
      örnek:
      google.co.uk, google.com.au, google.de vb.

    • tag
      Tür: string | null

      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

Yanıtlar
  • 200
    Tür: object | null · Response36Afe1097B20_MerchantGoogleProductInfoTaskPostResponseInfo
    • cost
      Tür: number | null Biçim: double

      toplam görev maliyeti, USD

    • status_code
      Tür: integer | null

      genel durum kodu yanıt kodlarının tam listesini burada bulabilirsiniz

    • status_message
      Tür: string | null

      genel bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

    • tasks
      Tür: array (object | null)[] | null

      görev dizisi

      • Tür: object | null · Response36Afe1097B20_MerchantGoogleProductInfoTaskPostTaskInfo
        • cost
          Tür: number | null Biçim: double

          toplam görev maliyeti, USD

        • data
          Tür: object | null

          POST isteğinde belirttiğiniz parametrelerin aynısını içerir

          • propertyName
            Tür: object | null
        • id
          Tür: string | null

          görev tanımlayıcısı sistemimizde UUID biçiminde benzersiz görev tanımlayıcısı

        • path
          Tür: array (string | null)[] | null

          URL yolu

        • result
          Tür: object | null

          sonuç dizisi
          bu durumda değer null olur

        • result_count
          Tür: integer | null Biçim: int64

          result dizisindeki öğe sayısı

        • status_code
          Tür: integer | null

          görevin durum kodu DataForSEO tarafından oluşturulur; şu aralıkta olabilir: 10000-60000 yanıt kodlarının tam listesini burada bulabilirsiniz

        • status_message
          Tür: string | null

          görevin bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

        • time
          Tür: string | null

          yürütme süresi, saniye

    • tasks_count
      Tür: integer | null Biçim: int64

      tasks dizisindeki görev sayısı

    • tasks_error
      Tür: integer | null Biçim: int64

      tasks dizisinde hata ile dönen görev sayısı

    • time
      Tür: string | null

      toplam yürütme süresi, saniye

    • version
      Tür: string | null

      API'nin geçerli sürümü

    application/json
  • 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
Request Example for post/v1/beta/dataforseo/merchant/google/product_info/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/google/product_info/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "product_id": "1113158713975221117"
  }
]'

{
  "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
    }
  ]
}

Başarılı işlem

Setting Google Shopping Product Info Tasks