Как получить локализованные заголовки и описания для автоматически сгенерированных каналов с помощью Youtube API v3?

У меня есть приложение, использующее API YouTube v3, которое позволяет просматривать видео через API гида, переходя от категорий гида к каналам и видео.

Я хотел бы предоставить локализованные результаты, но получить текст на английском языке в тех местах, где я ожидаю местных описаний. Я понимаю, что не могу ожидать, что каналы, принадлежащие пользователям, будут локализованы, но некоторые из результатов, по-видимому, являются автоматически сгенерированными каналами, которые будут отображаться в Интернете в переводе.

Я могу легко получить список категорий гидов, например. Испанский с призывом к youtube.guideCategories.list(part=snippet, hl=es-ES, regionCode=ES):

{
  "kind": "youtube#guideCategoryListResponse",
  "etag": "\"MmqJLb8ZBOWRQIsg7xej7lrKLMI/RxpLDjICTxI6pEJgKxa1GihOABg\"",
  "items": [
    {
      "kind": "youtube#guideCategory",
      "etag": "\"MmqJLb8ZBOWRQIsg7xej7lrKLMI/fnL4T7wf3HKS8VCeb2Mui5q9zeM\"",
      "id": "GCQmVzdCBvZiBZb3VUdWJl",
      "snippet": {
        "channelId": "UCBR8-60-B28hp2BmDPdntcQ",
        "title": "Best of YouTube"
      }
    },
    ...
    {
      "kind": "youtube#guideCategory",
      "etag": "\"MmqJLb8ZBOWRQIsg7xej7lrKLMI/a2ukJS2cvl7NN20p8C2B9uYePoM\"",
      "id": "GCTXVzaWM",
      "snippet": {
        "channelId": "UCBR8-60-B28hp2BmDPdntcQ",
        "title": "Música"
      }
    },
    ...
  }
}

Помимо нескольких результатов, таких как «Лучшее на YouTube», это возвращает локализованные названия категорий руководств, как я и ожидал. Проблема возникает, когда я хочу углубиться в одну из этих категорий.

Например, если я хочу получить каналы в категории "Лучшее на YouTube", я звоню youtube.channels.list(part=snippet, categoryId=GCQmVzdCBvZiBZb3VUdWJl):

{
  "kind": "youtube#channelListResponse",
  "etag": "\"MmqJLb8ZBOWRQIsg7xej7lrKLMI/o8HbT_CvdwGx45Gqb3VT3jnxz8Y\"",
  "nextPageToken": "CAUQAA",
  "pageInfo": {
    "totalResults": 9,
    "resultsPerPage": 5
  },
  "items": [
    {
      "kind": "youtube#channel",
      "etag": "\"MmqJLb8ZBOWRQIsg7xej7lrKLMI/3COvNpjUozOrHwTDRG2SKLHlbDs\"",
      "id": "UCEgdi0XIXXZ-qJOFPf4JSKw",
      "snippet": {
        "title": "Sports",
        "description": "Sport is all forms of usually competitive physical activity which, ....\nThis channel was generated automatically by YouTube's video discovery system.",
        "publishedAt": "2013-12-15T20:39:04.000Z",
        "thumbnails": {
          "default": {
            "url": "https://i.ytimg.com/i/Egdi0XIXXZ-qJOFPf4JSKw/1.jpg"
          },
          "medium": {
            "url": "https://i.ytimg.com/i/Egdi0XIXXZ-qJOFPf4JSKw/mq1.jpg"
          },
          "high": {
            "url": "https://i.ytimg.com/i/Egdi0XIXXZ-qJOFPf4JSKw/hq1.jpg"
          }
        }
      }
    },
    ...
  }
}

Как видите, этот автоматически сгенерированный канал возвращается с названием и описанием на английском языке. Этот API не документирован, чтобы принимать параметр hl для установки желаемого языка, и не будет вести себя иначе, если я все равно вызову его с этим параметром. Я также безуспешно пытался установить заголовок HTTP-запроса Accept-Language.

Если я просматриваю этот автоматически созданный канал на веб-сайте YouTube по адресу https://www.youtube.com/channel/UCEgdi0XIXXZ-qJOFPf4JSKw и измените язык веб-сайта на испанский. Я вижу локализованное название «Deportes» и соответствующее описание. Есть ли способ получить ту же информацию через API?


youtube-api internationalization youtube
person James Henstridge    schedule 01.10.2014    source источник

Ответы (2)


arrow_upward
1
arrow_downward

Интернационализация в Data API v3 — это то, что YT начал поддерживать недавно, и сейчас оно ограничено. Но работа над тем, чтобы в ближайшее время обеспечить поддержку всех функций в API, продолжается.

person Ibrahim Ulukaya    schedule 01.10.2014

arrow_upward
0
arrow_downward

Поскольку я разместил вопрос, похоже, что вызов YouTube channels.list получил параметр hl, что позволяет получать локализованные результаты.

Так, например, я могу получить локализованную для испанского языка версию категории "Лучшее из YouTube" с помощью вызова youtube.channels.list(part=snippet, categoryId=GCQmVzdCBvZiBZb3VUdWJl, hl=es-ES):

{
 "kind": "youtube#channelListResponse",
 "etag": "\"0KG1mRN7bm3nResDPKHQZpg5-do/5ZMIP3f0vZw8CYq69TcuOdye2ZQ\"",
 "nextPageToken": "CAUQAA",
 "pageInfo": {
  "totalResults": 10,
  "resultsPerPage": 5
 },
 "items": [
  ...
  {
   "kind": "youtube#channel",
   "etag": "\"0KG1mRN7bm3nResDPKHQZpg5-do/kLIkkfyIIZLFzhOb7gB4CIPzKJQ\"",
   "id": "UCEgdi0XIXXZ-qJOFPf4JSKw",
   "snippet": {
    "title": "#Sports",
    "description": "Sport or sports are all forms of usually competitive physical activity which, through casual or organised participation, aim to use, maintain or improve physical ability and skills while providing entertainment to participants, and in some cases, spectators. Usually the contest or game is between two sides, each attempting to exceed the other. Some sports allow a tie game; others provide tie-breaking methods, to ensure one winner and one loser. A number of such two-sided contests may be arranged in a tournament producing a champion. Many sports leagues make an annual champion by arranging games in a regular sports season, followed in some cases by playoffs. Hundreds of sports exist, from those between single contestants, through to those with hundreds of simultaneous participants, either in teams or competing as individuals. In certain sports such as racing, many contestants may compete, each against all w...\nThis channel was generated automatically by YouTube's video discovery system.",
    "publishedAt": "2013-12-15T20:39:04.000Z",
    "thumbnails": {
     "default": {
      "url": "https://i.ytimg.com/i/Egdi0XIXXZ-qJOFPf4JSKw/1.jpg"
     },
     "medium": {
      "url": "https://i.ytimg.com/i/Egdi0XIXXZ-qJOFPf4JSKw/mq1.jpg"
     },
     "high": {
      "url": "https://i.ytimg.com/i/Egdi0XIXXZ-qJOFPf4JSKw/hq1.jpg"
     }
    },
    "localized": {
     "title": "#Deportes",
     "description": "El deporte es una actividad física reglamentada, normalmente de carácter competitivo, que puede mejorar la condición física y ocasionalmente psíquica de quien lo practica, y tiene propiedades que lo diferencian del juego.\nLa RAE, en su Diccionario de la lengua española, define deporte como una «actividad física, ejercida como juego o competición, cuya práctica supone entrenamiento y sujeción a normas»; también, en una segunda acepción, más amplia, como «recreación, pasatiempo, placer, diversión o ejercicio físico, por lo común al aire libre». Por otra parte, la Carta Europea del deporte lo define como: «Todas las formas de actividades físicas que mediante una participación organizada o no, tienen como objetivo la expresión o la mejora de la condición física y psíquica, el desarrollo de las relaciones sociales o la obtención de resultados en competición de todos los niveles».\nInstitucionalmente, para...\nEl sistema de detección de vídeos de YouTube ha generado este canal automáticamente."
    }
   }
  },
  ...
 }
}

Локализованный заголовок и описание отображаются под новым атрибутом localized объекта канала.

person James Henstridge    schedule 05.11.2015