svemagie/indiekit-endpoint-youtube
1
0
Fork 0
mirror of https://github.com/svemagie/indiekit-endpoint-youtube.git synced 2026-04-02 15:54:59 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs: document baseline-first sync, MongoDB collections, troubleshooting

Browse Source 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
svemagie
2026-03-18 21:43:08 +01:00
parent 252a228653
commit ab5380bf19
1 changed files with 38 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

39
README.md
View File

@@ -291,7 +291,24 @@ Either `id` or `handle` is required. The `name` field is optional and used for d
## YouTube Likes Sync
Sync your YouTube liked videos as "like" posts on your IndieWeb blog. Each liked video becomes a like post with the video URL, title, channel name, and thumbnail.
Sync your YouTube liked videos as "like" posts on your IndieWeb blog. Only **new likes** (added after connecting) produce posts — existing likes are baselined without generating any content.
### How it works
```
First sync after connecting:
YouTube API → fetch all liked video IDs → store in youtubeLikesSeen collection
(no posts created — baseline snapshot only)
Every subsequent sync (hourly background + manual trigger):
YouTube API → fetch liked videos → compare against youtubeLikesSeen
↓ new like found (not in seen set)
Insert into youtubeLikesSeen + create "like" post in posts collection
↓ already seen
Skip
```
The baseline prevents mass post creation when you connect an account with hundreds of existing likes.
### Setup
@@ -328,6 +345,8 @@ Sync your YouTube liked videos as "like" posts on your IndieWeb blog. Each liked
7. Visit `/youtube/likes` in the Indiekit admin panel and click **Connect YouTube Account**
8. Authorize access — your refresh token is stored in MongoDB and persists across restarts
> **Brand Account caveat:** If your YouTube channel runs under a Brand Account, you must select that account (not your personal Google account) during the OAuth consent screen. The `myRating=like` API only returns likes for the authenticated account. Selecting the wrong account results in an "account is closed" error.
### Likes Options
| Option | Default | Description |
@@ -356,6 +375,13 @@ Sync your YouTube liked videos as "like" posts on your IndieWeb blog. Each liked
| `GET /youtube/likes/callback` | OAuth callback (Google redirects here) |
| `GET /youtube/api/likes` | JSON API for synced likes (`?limit=N&offset=N`) |
### MongoDB Collections
| Collection | Purpose |
|------------|---------|
| `youtubeMeta` | OAuth tokens (`key: "oauth_tokens"`), sync status (`key: "likes_sync"`), baseline flag (`key: "likes_baseline"`) |
| `youtubeLikesSeen` | Set of all video IDs ever seen (indexed on `videoId`, unique). Prevents duplicate posts and ensures only new likes after baseline produce posts. |
### Likes API Response
#### GET /youtube/api/likes
@@ -400,6 +426,17 @@ export default async function() {
}
```
### Troubleshooting
**"The YouTube account of the authenticated user is closed"**
You authorized the wrong Google account. Your liked videos live on a Brand Account, but OAuth used your personal account. Disconnect (`POST /youtube/likes/disconnect`), reconnect, and pick the correct account.
**First sync created zero posts**
This is expected. The first sync snapshots existing likes as baseline. Posts are only created for likes added after that point.
**Want to reset the baseline?**
Delete the `likes_baseline` document from `youtubeMeta` and all documents from `youtubeLikesSeen`. The next sync will re-baseline.
## Quota Efficiency
YouTube Data API has a daily quota (10,000 units by default). This plugin is optimized: