> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bgms.live/llms.txt
> Use this file to discover all available pages before exploring further.

# 음악 검색 설정하기

> 3-5분이면 완료! 검색 기능을 쉽게 활성화하는 방법

# 음악 검색 더 쉽게 하기

> [!NOTE]
>
> **채널 멤버 중 한 명만 설정하면 모두 사용 가능합니다!**
>
> 한 명이 3-5분만 투자하면, 채널의 모든 멤버가 음악 검색 기능을 함께 사용할 수 있습니다. 생각보다 훨씬 간단합니다!

## 검색 기능이란?

BGMS에서 YouTube 음악을 쉽게 찾을 수 있도록 도와주는 기능입니다. 음악 제목이나 아티스트 이름만 입력하면 바로 재생할 수 있습니다.

## 왜 설정이 필요한가요?

YouTube에서 음악을 검색하려면 Google의 허락이 필요합니다. 그래서 간단한 인증 절차가 필요합니다. **하지만 걱정하지 마세요** - 채널 멤버 중 누구든 한 명만 설정하면 됩니다!

## Google Access Token이란?

YouTube API에 접근할 수 있는 권한을 부여하는 인증 키입니다. 마치 YouTube 검색을 사용할 수 있는 '출입증'이라고 생각하시면 됩니다.

## 설정 방법

1. BGMS 설정 페이지에서 검색 설정 메뉴 열기
2. Google 계정으로 로그인
3. Access Token 발급받기
4. Token을 BGMS에 입력
5. 완료!

> [!NOTE]
>
> **설정 페이지에 자세한 가이드가 있습니다**
>
> BGMS 설정 페이지에 단계별 도움말이 준비되어 있습니다. 화면 안내를 따라가면 쉽게 설정할 수 있습니다.

## 문제가 생겼나요?

문제가 발생하면 Token을 다시 발급받아 보세요. 처음부터 다시 시도하면 대부분 해결됩니다.

## 보안 안내

> [!WARNING]
>
> **Token은 개인 정보입니다**
>
> * Token을 타인과 공유하지 마세요
> * 공개 채널에 Token을 올리지 마세요
> * Token이 유출되었다면 즉시 재발급받으세요

Token은 YouTube API 사용 권한만 부여하며, 여러분의 Google 계정 비밀번호나 개인 정보에는 접근할 수 없습니다.

## 검색 없이도 사용 가능합니다

검색 기능을 설정하지 않아도 BGMS를 충분히 즐길 수 있습니다:

* **다른 멤버가 추가한 음악 듣기**: 누군가 이미 추가한 곡들을 재생할 수 있습니다
* **재생목록 관리**: 기존 음악들을 자유롭게 관리하고 재생할 수 있습니다
* **YouTube URL 직접 입력**: URL을 알고 있다면 바로 추가 가능합니다

> [!NOTE]
>
> **팀 협력이 가능합니다**
>
> 채널 멤버 중 한 명이라도 검색 기능을 설정하면, 모든 멤버가 함께 사용할 수 있습니다. 팀원과 협력해보세요!

## 자주 묻는 질문

**Q: 꼭 내 Google 계정을 사용해야 하나요?**
A: 네, 본인의 Google 계정으로 인증해야 합니다. 하지만 채널 멤버 중 한 명만 설정하면 됩니다.

**Q: 설정에 얼마나 걸리나요?**
A: 처음 하시는 경우 5분 정도면 충분합니다. 익숙해지면 2-3분이면 완료됩니다.

**Q: Token은 얼마나 자주 갱신해야 하나요?**
A: Token 만료 시기는 다양합니다. 만료되면 알림이 표시되므로, 그때 다시 발급받으면 됩니다.

**Q: 여러 명이 각자 설정하면 어떻게 되나요?**
A: 문제없습니다! 각자 설정할 수도 있고, 한 명만 설정해서 공유할 수도 있습니다.

***

> [!TIP]
>
> **시작이 반입니다!**
>
> 처음엔 어려워 보여도, 한 번 해보면 생각보다 간단합니다. BGMS 설정 페이지의 안내를 따라가보세요. 3-5분이면 완료됩니다!


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.