Skip to content

Commit 3ec2537

Browse files
committed
add editorconfig and quota section to readme
1 parent 8387287 commit 3ec2537

2 files changed

Lines changed: 41 additions & 11 deletions

File tree

.editorconfig

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
root = true
2+
3+
[*]
4+
indent_style = space
5+
indent_size = 4
6+
end_of_line = lf
7+
charset = utf-8
8+
trim_trailing_whitespace = true
9+
insert_final_newline = true
10+
11+
[*.md]
12+
max_line_length = 100
13+
14+
[*.{yml,yaml,toml}]
15+
indent_size = 2

README.md

Lines changed: 26 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -11,10 +11,11 @@ Manage and analyze your YouTube channel from the terminal. Ideal for automation
1111

1212
## Motivation
1313

14-
I built this because I needed to bulk update video titles for a YouTube channel I manage with 300+ videos. YouTube
15-
Studio does not support bulk search-replace operations, which made it a tedious manual process. This tool uses the
16-
YouTube Data API to perform bulk operations on video metadata. Furthermore, it provides features for analytics and
17-
comment moderation, all accesible from the command line.
14+
I built this because I needed to bulk update video titles for a YouTube channel I manage with 300+
15+
videos. YouTube Studio does not support bulk search-replace operations, which made it a tedious
16+
manual process. This tool uses the YouTube Data API to perform bulk operations on video metadata.
17+
Furthermore, it provides features for analytics and comment moderation, all accesible from the
18+
command line.
1819

1920
## Installation
2021

@@ -27,19 +28,19 @@ uv tool install ytstudio-cli
2728
## Setup
2829

2930
1. Create a [Google Cloud project](https://console.cloud.google.com/)
30-
2. Enable **YouTube Data API v3** and **YouTube Analytics API**
31-
3. Configure OAuth consent screen:
31+
1. Enable **YouTube Data API v3** and **YouTube Analytics API**
32+
1. Configure OAuth consent screen:
3233
- Go to **APIs & Services****OAuth consent screen**
3334
- Select **External** and create
3435
- Fill in app name and your email
3536
- Skip scopes, then add yourself as a test user
3637
- Leave the app in "Testing" mode (no verification needed)
37-
4. Create OAuth credentials:
38+
1. Create OAuth credentials:
3839
- Go to **APIs & Services****Credentials**
39-
- Click **Create Credentials****OAuth client ID**
40+
- Click **Create Credentials****OAuth client ID**how
4041
- Select **Desktop app** as application type
4142
- Download the JSON file
42-
5. Configure ytstudio:
43+
1. Configure ytstudio:
4344

4445
```bash
4546
ytstudio init --client-secrets path/to/client_secret_<id>.json
@@ -48,7 +49,21 @@ ytstudio login
4849

4950
Credentials stored in `~/.config/ytstudio/`.
5051

52+
## API quota
53+
54+
The YouTube Data API enforces a default quota of 10_000 units per project per day. Most read
55+
operations (listing videos, comments, channel info) cost 1 unit, while write operations like
56+
updating video metadata or moderating comments cost 50 units each. Bulk updates can consume quota
57+
quickly. When exceeded, the API returns a 403 error; quota resets at midnight Pacific Time.
58+
59+
You can request a quota increase via **IAM & Admin****Quotas** in the
60+
[Google Cloud Console](https://console.cloud.google.com/). See the
61+
[official quota documentation](https://developers.google.com/youtube/v3/getting-started#quota) for
62+
full details.
63+
5164
## Disclaimer
5265

53-
This project is not affiliated with or endorsed by Google. YouTube and YouTube Studio are trademarks of Google.
54-
All channel data is accessed exclusively through the official [YouTube Data API](https://developers.google.com/youtube/v3) and [YouTube Analytics API](https://developers.google.com/youtube/analytics).
66+
This project is not affiliated with or endorsed by Google. YouTube and YouTube Studio are trademarks
67+
of Google. All channel data is accessed exclusively through the official
68+
[YouTube Data API](https://developers.google.com/youtube/v3) and
69+
[YouTube Analytics API](https://developers.google.com/youtube/analytics).

0 commit comments

Comments
 (0)