Felo API PlatformFelo API Platform
endpoint ทั้งหมดของ DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

ตั้งงาน Google Shopping Reviews

Felo API Support
MIT
เซิร์ฟเวอร์:https://openapi.felo.ai
ไลบรารีไคลเอนต์
Shell Curl

DataForSEO

​

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

DataForSEO การดำเนินการ

ตั้งงาน Google Shopping Reviews

​

เข้าคิวรีวิวของสินค้า Google Shopping หนึ่งรายการ และคืน id ของงาน ระบุสินค้าด้วย product_id พร้อม gid หรือ data_docid จากผลลัพธ์สินค้า ตระกูลนี้เป็นแบบอะซิงโครนัสตลอดสาย: การ submit จะคืน id ของงานใน tasks[0].id และเครื่องมือ fetch จะคืนผลลัพธ์เมื่อพร้อม ดึงผลด้วย get_dataforseo_merchant_google_reviews_fetch

ข้อมูลอ้างอิงราคา

  • การวัดปริมาณการใช้งาน: ต้นทุนการตอบกลับที่รายงาน
  • ค่าประมาณคำขออ้างอิง: USD 0.012
  • ตัวคูณอ้างอิงสำหรับลูกค้า: 1.0 ห้ามนำไปใช้ซ้ำกับยอดที่เรียกเก็บจากลูกค้าแล้ว

เป็นข้อมูลเมตาอ้างอิงเท่านั้น ไม่ใช่ใบเสนอราคาสำหรับบัญชี ไม่ใช่ราคาที่รับประกัน และไม่ใช่เพดานการใช้จ่าย เครดิตของทรัพยากรไม่ใช่เครดิต Felo ยอดเรียกเก็บขั้นสุดท้ายเป็นไปตามบันทึกการเรียกเก็บเงินของ Felo

บอดี้
จำเป็น
application/json
  • ประเภท: array object[]
    • ประเภท: object
      • gid
        ประเภท: string
        จำเป็น

        ตัวระบุผลิตภัณฑ์ระดับโลกบน Google Shopping ฟิลด์ที่จำเป็น เราแนะนำให้ระบุ gid ร่วมกับ data_docid และ product_id เพื่อผลลัพธ์ที่ดีที่สุด; คุณสามารถรับค่านี้สำหรับผลิตภัณฑ์หนึ่งๆ ได้โดยส่งคำขอแยกไปที่ endpoint Google Shopping Products ตัวอย่าง: 4702526954592161872 ดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์ได้ในคู่มือ Help Center นี้

      • data_docid
        ประเภท: string

        ตัวระบุเฉพาะขององค์ประกอบข้อมูล SERP ฟิลด์ที่ไม่บังคับ เราแนะนำให้ระบุ data_docid ร่วมกับ product_id และ gid เพื่อผลลัพธ์ที่ดีที่สุด; คุณสามารถรับค่านี้สำหรับองค์ประกอบหนึ่งๆ ได้โดยส่งคำขอแยกไปที่ endpoint Google Shopping Products ตัวอย่าง: 13071766526042404278

      • depth
        ประเภท: integer

        ความลึกในการดึงข้อมูล ฟิลด์ที่ไม่บังคับ จำนวนรีวิวใน SERP; ขอแนะนำอย่างยิ่งให้ตั้งค่าความลึกเป็นจำนวนเท่าของสิบ เนื่องจากระบบของเราประมวลผลรีวิวครั้งละสิบรายการ; ค่าสูงสุด: 8000 ค่าเริ่มต้น: 10 บัญชีของคุณจะถูกเรียกเก็บเงินสำหรับแต่ละ SERP ที่มีผลลัพธ์สูงสุด 10 รายการ; การตั้งค่าความลึกเกิน 10 อาจทำให้เกิดค่าใช้จ่ายเพิ่มเติมหากเครื่องมือค้นหาคืนผลลัพธ์มากกว่า 10 รายการ; สามารถคำนวณค่าใช้จ่ายได้ที่หน้า Pricing

      • language_code
        ประเภท: string

        รหัสภาษาของเครื่องมือค้นหา ฟิลด์ที่จำเป็นหากคุณไม่ระบุ language_name หากใช้ฟิลด์นี้ ไม่จำเป็นต้องระบุ language_name คุณสามารถรับรายการภาษาที่ใช้ได้พร้อมพารามิเตอร์ language_code ได้โดยส่งคำขอแยกไปที่ https://api.dataforseo.com/v3/merchant/google/languages ตัวอย่าง: en_GB

      • language_name
        ประเภท: string

        ชื่อเต็มของภาษาของเครื่องมือค้นหา ฟิลด์ที่จำเป็นหากคุณไม่ระบุ language_code หากใช้ฟิลด์นี้ ไม่จำเป็นต้องระบุ language_code คุณสามารถรับรายการภาษาที่ใช้ได้พร้อมพารามิเตอร์ language_name ได้โดยส่งคำขอแยกไปที่ https://api.dataforseo.com/v3/merchant/google/languages ตัวอย่าง: English (United Kingdom)

      • location_code
        ประเภท: integer

        รหัสสถานที่ของเครื่องมือค้นหา ฟิลด์ที่จำเป็นหากคุณไม่ระบุ location_name หรือ location_coordinate หากใช้ฟิลด์นี้ ไม่จำเป็นต้องระบุ location_name หรือ location_coordinate คุณสามารถรับรายการสถานที่ที่ใช้ได้พร้อมพารามิเตอร์ location_code ได้โดยส่งคำขอแยกไปที่ https://api.dataforseo.com/v3/merchant/google/locations ตัวอย่าง: 9045969

      • location_coordinate
        ประเภท: string

        พิกัด GPS ของสถานที่ ฟิลด์ที่จำเป็นหากคุณไม่ระบุ location_name หรือ location_code หากใช้ฟิลด์นี้ ไม่จำเป็นต้องระบุ location_name หรือ location_code ต้องระบุพารามิเตอร์ location_coordinate ในรูปแบบ “latitude,longitude,radius” จำนวนหลักทศนิยมสูงสุดสำหรับ “latitude” และ “longitude”: 7 ค่าต่ำสุดสำหรับ “radius”: 199.9 ตัวอย่าง: 53.476225,-2.243572,200

      • location_name
        ประเภท: string

        ชื่อเต็มของสถานที่ของเครื่องมือค้นหา ฟิลด์ที่จำเป็นหากคุณไม่ระบุ location_code หรือ location_coordinate หากใช้ฟิลด์นี้ ไม่จำเป็นต้องระบุ location_code หรือ location_coordinate คุณสามารถรับรายการสถานที่ที่ใช้ได้พร้อมพารามิเตอร์ location_name ได้โดยส่งคำขอแยกไปที่ https://api.dataforseo.com/v3/merchant/google/locations ตัวอย่าง: HA1,England,United Kingdom

      • pingback_url
        ประเภท: string

        URL แจ้งเตือนของงานที่เสร็จสิ้น ฟิลด์ไม่บังคับ เมื่องานเสร็จสิ้น เราจะแจ้งให้คุณทราบด้วยคำขอ GET ที่ส่งไปยัง URL ที่คุณระบุ คุณสามารถใช้สตริง ‘$id’ เป็นตัวแปร $id และ ‘$tag’ เป็นตัวแปร $tag ที่เข้ารหัส URL ได้ เราจะตั้งค่าที่จำเป็นก่อนส่งคำขอ ตัวอย่าง: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag หมายเหตุ: อักขระพิเศษใน pingback_url จะถูกเข้ารหัส URL เช่น อักขระ # จะถูกเข้ารหัสเป็น %23 ดูข้อมูลเพิ่มเติมได้ที่ Help Center ของเรา

      • postback_data
        ประเภท: string

        postback_url datatype ฟิลด์ไม่บังคับ ระบุชนิดข้อมูลที่จะส่งไปยังเซิร์ฟเวอร์ของคุณ ค่าที่เป็นไปได้: advanced

      • postback_url
        ประเภท: string

        URL สำหรับส่งผลลัพธ์ของงาน ฟิลด์ไม่บังคับ เมื่องานเสร็จสิ้น เราจะส่งคำขอ POST พร้อมผลลัพธ์ที่บีบอัดในรูปแบบ gzip ไปยัง postback_url ที่คุณระบุ คุณสามารถใช้สตริง ‘$id’ เป็นตัวแปร $id และ ‘$tag’ เป็นตัวแปร $tag ที่เข้ารหัส URL ได้ เราจะตั้งค่าที่จำเป็นก่อนส่งคำขอ ตัวอย่าง: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag หมายเหตุ: อักขระพิเศษใน postback_url จะถูกเข้ารหัส URL เช่น อักขระ # จะถูกเข้ารหัสเป็น %23 ดูข้อมูลเพิ่มเติมได้ที่ Help Center ของเรา

      • priority
        ประเภท: integer

        ลำดับความสำคัญของงาน ฟิลด์ไม่บังคับ รับค่าได้ดังนี้: 1 – ลำดับความสำคัญปกติ (ตั้งเป็นค่าเริ่มต้น) 2 – ลำดับความสำคัญสูง งานที่มีลำดับความสำคัญสูงจะถูกเรียกเก็บเงินเพิ่ม คำนวณค่าใช้จ่ายได้ที่หน้าราคา

      • product_id
        ประเภท: string

        ตัวระบุผลิตภัณฑ์เฉพาะบน Google Shopping ฟิลด์ไม่บังคับ เราแนะนำให้ระบุ product_id ร่วมกับ data_docid และ gid เพื่อผลลัพธ์ที่ดีที่สุด; คุณสามารถรับค่านี้สำหรับผลิตภัณฑ์หนึ่งๆ ได้โดยส่งคำขอแยกไปยัง endpoint Google Shopping Products ตัวอย่าง: 4485466949985702538 ศึกษาข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์นี้ได้ในคู่มือ Help Center

      • se_domain
        ประเภท: string

        โดเมนของเครื่องมือค้นหา ฟิลด์ไม่บังคับ เราเลือกโดเมนเครื่องมือค้นหาที่เกี่ยวข้องโดยอัตโนมัติตามสถานที่และภาษาที่คุณระบุ อย่างไรก็ตาม คุณสามารถตั้งโดเมนเครื่องมือค้นหาแบบกำหนดเองได้ในฟิลด์นี้ ตัวอย่าง: google.co.uk, google.com.au, google.de เป็นต้น

      • tag
        ประเภท: string

        ตัวระบุงานที่ผู้ใช้กำหนด ฟิลด์ไม่บังคับ จำกัด 255 อักขระ ใช้พารามิเตอร์นี้เพื่อระบุงานและจับคู่กับผลลัพธ์ คุณจะพบค่า tag ที่ระบุในออบเจ็กต์ data ของการตอบกลับ

      ออบเจ็กต์ว่าง
      ออบเจ็กต์ว่าง
การตอบกลับ
  • 200
    ประเภท: object

    การตอบกลับสำเร็จ

    • cost
      ประเภท: number

      ค่าใช้จ่ายรวมของงาน, USD

    • status_code
      ประเภท: integer

      รหัสสถานะทั่วไป คุณสามารถดูรายการรหัสการตอบกลับทั้งหมดได้ที่นี่ หมายเหตุ: เราขอแนะนำอย่างยิ่งให้ออกแบบระบบที่จำเป็นสำหรับการจัดการเงื่อนไขที่ผิดปกติหรือข้อผิดพลาดที่เกี่ยวข้อง

    • status_message
      ประเภท: string

      ข้อความข้อมูลทั่วไป คุณสามารถดูรายการข้อความข้อมูลทั่วไปทั้งหมดได้ที่นี่

    • tasks
      ประเภท: array string[]

      อาร์เรย์ของงาน

    • tasks_count
      ประเภท: integer

      จำนวนงานใน tasksarray

    • tasks_error
      ประเภท: integer

      จำนวนงานในอาร์เรย์ tasks ที่ส่งคืนพร้อมข้อผิดพลาด

    • tasks.cost
      ประเภท: number

      ค่าใช้จ่ายของงาน, USD

    • tasks.data
      ประเภท: object

      มีพารามิเตอร์เดียวกับที่คุณระบุในคำขอ POST

    • tasks.id
      ประเภท: string

      ตัวระบุงานที่ไม่ซ้ำกันในระบบของเราในรูปแบบ Universally unique identifier (UUID)

    • tasks.path
      ประเภท: array string[]

      พาธ URL

    • tasks.result
      ประเภท: array string[]

      อาร์เรย์ของผลลัพธ์ ในกรณีนี้ ค่าจะเป็น null

    • tasks.result_count
      ประเภท: integer

      จำนวนองค์ประกอบในอาร์เรย์ result

    • tasks.status_code
      ประเภท: integer

      รหัสสถานะของงานที่สร้างโดย DataForSEO; อยู่ในช่วงต่อไปนี้ได้: 10000-60000

    • tasks.status_message
      ประเภท: string

      ข้อความข้อมูลของงาน

    • tasks.time
      ประเภท: string

      เวลาดำเนินการ, วินาที

    • time
      ประเภท: string

      เวลาดำเนินการ, วินาที

    • version
      ประเภท: string

      เวอร์ชันปัจจุบันของ API

    application/json
  • 400

    ไม่สามารถประมวลผลคำขอได้ ตรวจสอบพารามิเตอร์ของคำขอ

  • 401

    จำเป็นต้องใช้คีย์ API ของ Felo ที่ถูกต้อง

  • 402

    ไม่สามารถดำเนินการตามคำขอได้ เนื่องจากไม่เป็นไปตามข้อกำหนดด้านการเรียกเก็บเงิน

  • 403

    บัญชีไม่ได้รับอนุญาตให้ดำเนินการนี้

  • 429

    ถึงขีดจำกัดคำขอหรือการใช้จ่ายแล้ว

  • 502

    บริการไม่สามารถดำเนินการตามคำขอให้เสร็จสิ้นได้

  • 503

    API หรือบริการเรียกเก็บเงินไม่พร้อมใช้งานชั่วคราว

  • 504

    บริการหมดเวลาระหว่างประมวลผลคำขอ

  • default

    การตอบกลับข้อผิดพลาด; การตอบกลับที่ส่งผ่านจากต้นทางอาจใช้รูปแบบของผู้ให้บริการ

    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