# Mencipta Tugas Sari Kata YouTube

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/serp/youtube/video_subtitles/task_post`

**Tags:** DataForSEO

Memasukkan trek sari kata satu video YouTube di YouTube ke dalam baris gilir, memulangkan `id` tugas dalam `tasks[0].id`. Dibungkus dalam sampul DataForSEO: data dalam `tasks[0].result`, hasil dalam `tasks[0].status_code` - permintaan yang ditolak tetap memulangkan HTTP 200. Kembar langsung menjawab serta-merta dan lebih mudah untuk satu pertanyaan; masukkan ke baris gilir apabila kelompok akan melebihi satu panggilan alat.

### Rujukan harga

- Pemeteran: Kos respons yang dilaporkan.
- Anggaran rujukan setiap permintaan: USD 0.02.
- Pengganda pelanggan rujukan: 1.0. Jangan gunakan semula pada amaun pelanggan yang telah diselesaikan.

Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.

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

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "video_id": {
            "type": "string",
            "description": "ID video\nmedan wajib\nanda boleh menemui ID video dalam URL atau item 'youtube_video' hasil YouTube Organic\ncontoh:\nY8Wu4rSNJms"
          },
          "location_code": {
            "type": [
              "integer",
              "null"
            ],
            "description": "kod lokasi enjin carian\nmedan wajib jika anda tidak menentukan location_name\njika anda menggunakan medan ini, anda tidak perlu menentukan location_name\nanda boleh mendapatkan senarai lokasi enjin carian yang tersedia bersama location_code dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/youtube/locations\ncontoh:\n2840"
          },
          "language_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "kod bahasa enjin carian\nmedan wajib jika anda tidak menentukan language_name\njika anda menggunakan medan ini, anda tidak perlu menentukan language_name\nanda boleh mendapatkan senarai bahasa enjin carian yang tersedia bersama language_code dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/youtube/languages\ncontoh:\nen"
          },
          "priority": {
            "type": [
              "integer",
              "null"
            ],
            "description": "keutamaan tugas\nmedan pilihan\nboleh mengambil nilai berikut:\n1 – keutamaan pelaksanaan biasa (ditetapkan secara lalai)\n2 – keutamaan pelaksanaan tinggi\nAnda akan dicaj tambahan untuk tugas dengan keutamaan pelaksanaan tinggi.\nKos boleh dikira di halaman Harga."
          },
          "device": {
            "type": [
              "string",
              "null"
            ],
            "description": "jenis peranti\nmedan pilihan\nhanya nilai: desktop"
          },
          "pingback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "URL pemberitahuan tugas yang selesai\nmedan pilihan\napabila tugas selesai, kami akan memberitahu anda melalui permintaan GET yang dihantar ke URL yang anda tentukan\nanda boleh menggunakan rentetan ‘$id’ sebagai pemboleh ubah $id dan ‘$tag’ sebagai pemboleh ubah $tag yang di-urlencode. Kami akan menetapkan nilai yang diperlukan sebelum menghantar permintaan.\ncontoh:\nhttp://your-server.com/pingscript?id=$id\nhttp://your-server.com/pingscript?id=$id&tag=$tag\nNota: aksara khas dalam pingback_url akan di-urlencode;\niaitu, aksara # akan dikodkan menjadi %23\nketahui lebih lanjut di Pusat Bantuan kami"
          },
          "postback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "URL pulangan untuk menghantar hasil tugas\nmedan pilihan\nselepas tugas selesai, kami akan menghantar permintaan POST dengan hasilnya yang dimampatkan dalam format gzip ke postback_url yang anda tentukan\nanda boleh menggunakan rentetan ‘$id’ sebagai pemboleh ubah $id dan ‘$tag’ sebagai pemboleh ubah $tag yang di-urlencode. Kami akan menetapkan nilai yang diperlukan sebelum menghantar permintaan.\ncontoh:\nhttp://your-server.com/postbackscript?id=$id\nhttp://your-server.com/postbackscript?id=$id&tag=$tag\nNota: aksara khas dalam postback_url akan di-urlencode;\niaitu, aksara # akan dikodkan menjadi %23\nketahui lebih lanjut di Pusat Bantuan kami"
          },
          "postback_data": {
            "type": [
              "string",
              "null"
            ],
            "description": "jenis data postback_url\nmedan wajib jika anda menentukan postback_url\nsepadan dengan jenis data yang akan dihantar ke pelayan anda\nnilai yang mungkin:\nadvanced"
          },
          "location_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "nama penuh lokasi enjin carian\nmedan wajib jika anda tidak menentukan location_code\njika anda menggunakan medan ini, anda tidak perlu menentukan location_code\nanda boleh mendapatkan senarai lokasi enjin carian yang tersedia bersama location_name dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/youtube/locations\ncontoh:\nUnited States"
          },
          "language_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "nama penuh bahasa enjin carian\nmedan wajib jika anda tidak menentukan language_code\njika anda menggunakan medan ini, anda tidak perlu menentukan language_code\nanda boleh mendapatkan senarai bahasa enjin carian yang tersedia bersama language_name dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/youtube/languages\ncontoh:\nEnglish"
          },
          "os": {
            "type": [
              "string",
              "null"
            ],
            "description": "sistem pengendalian peranti\nmedan pilihan\npilih daripada nilai berikut: windows, macos\nnilai lalai: windows"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "pengecam tugas yang ditentukan pengguna\nmedan pilihan\nhad aksara ialah 255\nanda boleh menggunakan parameter ini untuk mengenal pasti tugas dan memadankannya dengan hasil\nanda akan menemui nilai tag yang ditentukan dalam objek data respons"
          },
          "subtitles_language": {
            "type": [
              "string",
              "null"
            ],
            "description": "kod bahasa teks asal\nanda boleh mendapatkan kod bahasa daripada hasil YouTube Video Info"
          },
          "subtitles_translate_language": {
            "type": [
              "string",
              "null"
            ],
            "description": "kod bahasa teks terjemahan\nnilai yang mungkin:\n\"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\""
          }
        },
        "example": [
          {
            "language_code": "en",
            "location_code": 2840,
            "video_id": "Y8Wu4rSNJms"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "language_code": "en",
      "location_code": 2840,
      "video_id": "Y8Wu4rSNJms"
    }
  ]
}
```

## Responses

### 200 — Operasi berjaya

Headers:
- `X-Request-Id` (string) — Pengecam permintaan untuk disertakan semasa menghubungi sokongan Felo.

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_SerpYoutubeVideoSubtitlesTaskPostResponseInfo"
    }
  ]
}
```

### 400 — Permintaan tidak dapat diproses. Semak parameter permintaan.

### 401 — Kunci API Felo yang sah diperlukan.

### 402 — Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.

### 403 — Akaun tidak dibenarkan melakukan operasi ini.

### 429 — Had permintaan atau had perbelanjaan telah dicapai.

### 502 — Perkhidmatan tidak dapat menyelesaikan permintaan.

### 503 — API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.

### 504 — Perkhidmatan tamat masa semasa memproses permintaan.

### default — Respons ralat; respons passthrough huluan mungkin menggunakan format penyedia

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "versi semasa API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "kod status umum; anda boleh menemui senarai penuh kod respons di sini"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "jumlah masa pelaksanaan, saat"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "jumlah kos tugas, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "bilangan tugas dalam array tasks",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "bilangan tugas dalam array tasks yang dipulangkan dengan ralat",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "masa pelaksanaan, saat"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "jumlah kos tugas, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "bilangan elemen dalam array hasil",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "Laluan URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST"
    }
  }
}
```

### Response36Afe1097B20_SerpYoutubeVideoSubtitlesTaskPostResponseInfo

`#/components/schemas/Response36Afe1097B20_SerpYoutubeVideoSubtitlesTaskPostResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_SerpYoutubeVideoSubtitlesTaskPostTaskInfo"
              }
            ]
          },
          "description": "array tugas"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_SerpYoutubeVideoSubtitlesTaskPostTaskInfo

`#/components/schemas/Response36Afe1097B20_SerpYoutubeVideoSubtitlesTaskPostTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "object",
            "null"
          ],
          "description": "array hasil; dalam kes ini, nilainya akan null"
        }
      }
    }
  ]
}
```
