Felo API PlatformFelo API Platform
Semua endpoint DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Membuat Tugas Subtitle YouTube

Felo API Support
MIT
Server:https://openapi.felo.ai
Pustaka Klien
Shell Curl

DataForSEO

​

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

DataForSEO Operasi

Membuat Tugas Subtitle YouTube

​

Mengantrekan trek subtitle satu video YouTube di YouTube, mengembalikan id tugas di tasks[0].id. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Kembaran langsung menjawab segera dan lebih sederhana untuk satu kueri; antrekan bila batch akan melebihi satu panggilan alat.

Referensi harga

  • Metering: Biaya respons yang dilaporkan.
  • Estimasi referensi per permintaan: USD 0.02.
  • Pengali pelanggan referensi: 1.0. Jangan terapkan lagi pada jumlah pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.

Isi
application/json
  • Tipe: array (object | null)[]
    • device
      Tipe: string | null

      jenis perangkat field opsional hanya nilai: desktop

    • language_code
      Tipe: string | null

      kode bahasa mesin pencari field wajib jika Anda tidak menentukan language_name jika Anda menggunakan field ini, Anda tidak perlu menentukan language_name Anda dapat memperoleh daftar bahasa mesin pencari yang tersedia beserta language_code dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/youtube/languages contoh: en

    • language_name
      Tipe: string | null

      nama lengkap bahasa mesin pencari field wajib jika Anda tidak menentukan language_code jika Anda menggunakan field ini, Anda tidak perlu menentukan language_code Anda dapat memperoleh daftar bahasa mesin pencari yang tersedia beserta language_name dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/youtube/languages contoh: English

    • location_code
      Tipe: integer | null

      kode lokasi mesin pencari field wajib jika Anda tidak menentukan location_name jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia beserta location_code dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/youtube/locations contoh: 2840

    • location_name
      Tipe: string | null

      nama lengkap lokasi mesin pencari field wajib jika Anda tidak menentukan location_code jika Anda menggunakan field ini, Anda tidak perlu menentukan location_code Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia beserta location_name dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/youtube/locations contoh: United States

    • os
      Tipe: string | null

      sistem operasi perangkat field opsional pilih dari nilai berikut: windows, macos nilai default: windows

    • pingback_url
      Tipe: string | null

      URL notifikasi tugas yang selesai field opsional ketika tugas selesai, kami akan memberi tahu Anda melalui permintaan GET yang dikirim ke URL yang Anda tentukan Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag yang di-urlencode. Kami akan menetapkan nilai yang diperlukan sebelum mengirim permintaan. contoh: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag Catatan: karakter khusus dalam pingback_url akan di-urlencode; yaitu, karakter # akan dienkode menjadi %23 pelajari selengkapnya di Pusat Bantuan kami

    • postback_data
      Tipe: string | null

      tipe data postback_url field wajib jika Anda menentukan postback_url sesuai dengan tipe data yang akan dikirim ke server Anda nilai yang mungkin: advanced

    • postback_url
      Tipe: string | null

      URL pengembalian untuk mengirim hasil tugas field opsional setelah tugas selesai, kami akan mengirim permintaan POST dengan hasilnya yang dikompresi dalam format gzip ke postback_url yang Anda tentukan Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag yang di-urlencode. Kami akan menetapkan nilai yang diperlukan sebelum mengirim permintaan. contoh: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag Catatan: karakter khusus dalam postback_url akan di-urlencode; yaitu, karakter # akan dienkode menjadi %23 pelajari selengkapnya di Pusat Bantuan kami

    • priority
      Tipe: integer | null

      prioritas tugas field opsional dapat mengambil nilai berikut: 1 – prioritas eksekusi normal (ditetapkan secara default) 2 – prioritas eksekusi tinggi Anda akan dikenai biaya tambahan untuk tugas dengan prioritas eksekusi tinggi. Biaya dapat dihitung di halaman Harga.

    • subtitles_language
      Tipe: string | null

      kode bahasa teks asli Anda dapat memperoleh kode bahasa dari hasil YouTube Video Info

    • subtitles_translate_language
      Tipe: string | null

      kode bahasa teks terjemahan nilai yang mungkin: "az", "ay", "ak", "sq", "am", "en", "ar", "hy", "as", "af", "eu", "be", "bn", "my", "bg", "bs", "bho", "cy", "hu", "vi", "haw", "ht", "gl", "lg", "el", "ka", "gn", "gu", "gd", "da", "fy", "zu", "iw", "ig", "yi", "id", "ga", "is", "es", "it", "yo", "kk", "kn", "ca", "qu", "rw", "ky", "zh-Hant", "zh-Hans", "ko", "co", "xh", "ku", "km", "lo", "la", "lv", "ln", "lt", "lb", "mk", "mg", "ms", "ml", "dv", "mt", "mi", "mr", "mn", "und", "de", "ne", "nl", "no", "ny", "or", "om", "pa", "fa", "pl", "pt", "ps", "ro", "ru", "sm", "sa", "ceb", "nso", "sr", "si", "sd", "sk", "sl", "so", "sw", "su", "tg", "th", "ta", "tt", "te", "ti", "ts", "tr", "tk", "uz", "ug", "uk", "ur", "fil", "fi", "fr", "ha", "hi", "hmn", "hr", "cs", "sv", "sn", "ee", "eo", "et", "st", "jv", "ja", "kri"

    • tag
      Tipe: string | null

      pengenal tugas yang ditentukan pengguna field opsional batas karakter adalah 255 Anda dapat menggunakan parameter ini untuk mengidentifikasi tugas dan mencocokkannya dengan hasil Anda akan menemukan nilai tag yang ditentukan di objek data pada respons

    • video_id
      Tipe: string

      ID video field wajib Anda dapat menemukan ID video di URL atau item 'youtube_video' pada hasil YouTube Organic contoh: Y8Wu4rSNJms

Respons
  • 200
    Tipe: object | null · Response36Afe1097B20_SerpYoutubeVideoSubtitlesTaskPostResponseInfo
    • cost
      Tipe: number | null Format: double

      total biaya tugas, USD

    • status_code
      Tipe: integer | null

      kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini

    • status_message
      Tipe: string | null

      pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

    • tasks
      Tipe: array (object | null)[] | null

      array tugas

      • Tipe: object | null · Response36Afe1097B20_SerpYoutubeVideoSubtitlesTaskPostTaskInfo
        • cost
          Tipe: number | null Format: double

          total biaya tugas, USD

        • data
          Tipe: object | null

          berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST

          • propertyName
            Tipe: object | null
        • id
          Tipe: string | null

          pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID

        • path
          Tipe: array (string | null)[] | null

          Jalur URL

        • result
          Tipe: object | null

          array hasil; dalam kasus ini, nilainya akan null

        • result_count
          Tipe: integer | null Format: int64

          jumlah elemen dalam array hasil

        • status_code
          Tipe: integer | null

          kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini

        • status_message
          Tipe: string | null

          pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

        • time
          Tipe: string | null

          waktu eksekusi, detik

    • tasks_count
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks

    • tasks_error
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks yang dikembalikan dengan error

    • time
      Tipe: string | null

      total waktu eksekusi, detik

    • version
      Tipe: string | null

      versi API saat ini

    application/json
  • 400

    Permintaan tidak dapat diproses. Periksa parameter permintaan.

  • 401

    Kunci API Felo yang valid diperlukan.

  • 402

    Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.

  • 403

    Akun tidak diizinkan melakukan operasi ini.

  • 429

    Batas permintaan atau batas pengeluaran telah tercapai.

  • 502

    Layanan tidak dapat menyelesaikan permintaan.

  • 503

    API atau layanan penagihan untuk sementara tidak tersedia.

  • 504

    Layanan kehabisan waktu saat memproses permintaan.

  • default

    Respons error; respons passthrough upstream dapat menggunakan format penyedia

    application/json
Request Example for post/v1/beta/dataforseo/serp/youtube/video_subtitles/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/youtube/video_subtitles/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "video_id": "Y8Wu4rSNJms"
  }
]'

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

Operasi berhasil

Setting YouTube Subtitles Tasks