Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/CjDave/Plugin.YoutubeLibrary
A Xamarin.Forms Library for handling YouTube API requests
https://github.com/CjDave/Plugin.YoutubeLibrary
Last synced: 30 days ago
JSON representation
A Xamarin.Forms Library for handling YouTube API requests
- Host: GitHub
- URL: https://github.com/CjDave/Plugin.YoutubeLibrary
- Owner: CjDave
- License: mit
- Created: 2022-01-26T23:24:07.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2022-04-17T09:37:15.000Z (over 2 years ago)
- Last Synced: 2024-08-02T23:17:51.120Z (4 months ago)
- Language: C#
- Homepage:
- Size: 76.2 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-xamarin-forms - Plugin.YoutubeLibrary
README
# Plugin.YoutubeLibrary
A Xamarin Library for handling YouTube API requests
# Table of Contents
1. [Initialization](#Initialization)
2. [ Code version of Api requests](#Api_Requests)
3. [Playlists](#Playlists)
4. [Channels](#Channels)
4. [AnyRequests](#AnyRequests)
# Initialization
The Plugin could be created with only the api key or both an api key and an access token. provididng an acces token allows for more functionality
``` c#
using YoutubeLibrary.youtube;
public MainWindow()
{
string ApiKey = "API_KEY";
string Accesstoken = "ACCESS_TOKEN";
YoutubeClient youtube = new YoutubeClient(ApiKey);
YoutubeClient youtube2 = new YoutubeClient(ApiKey, Accesstoken);
}
```
# Code version of Api requests
An example of Api requests and the corresponding parts of the code
> POST https://youtube.googleapis.com/youtube/v3/playlists?part=snippet&part=contentDetails&prettyPrint=true&key=[API_KEY] HTTP/1.1
> A single parameter is:
> part=snippet
> Combination of multiple parameters
> part=contentDetails&prettyPrint=true
### Adding a parameter
``` c#
Parameter[] parameter = {new Parameter("prettyPrint", "true"), new Parameter("alt", "json")};
```
### Adding a body
Bodies are json objects, the Body_Item class is used to acheive this Json structure
Body_Item class can store a single value
``` c#
var b= new Body_Item("itemcount", "1")
//The equilavent
```
``` yaml
{
"itemCount": 1
}
```
**Or multiple Body_Item classes**
``` c#
Body_Item contentDetails = new Body_Item("contentDetails");
contentDetails.values.Add(new Body_Item("itemcount", "1"));
contentDetails.values.Add(new Body_Item("itemcount", "2"));
```
```yaml
"contentDetails": {
"itemCount": 1,
"itemCount": 2
}
*/
```
With this you are able to form Json objects
Example: The code equivalent of this Json
```yaml
{
"contentDetails": {
"itemCount": 1
},
"snippet": {
"title": "playlistsTitle",
"description": "playlistsDescription",
"localized": {
"title": "local",
"description": "localDescription"
}
}
}
```
``` c#
Body_Item snippetItems = new Body_Item("snippet");
snippetItems.values.Add(new Body_Item("title", "playlistTitle"));
snippetItems.values.Add(new Body_Item("description", "playlistsDescription"));
snippetItems.values.Add(new Body_Item("localized", new List { new Body_Item("title", "local"), new Body_Item("description", "LocalDescription") }));
Body_Item contentDetails = new Body_Item("contentDetails");
contentDetails.values.Add(new Body_Item("itemcount", "1"));
var body = new List { contentDetails, snippetItems}
```
## Retrieve playlists
To get the playlists calls the **youtubeClient.playlistsList.getPlaylistAsync(String[] part, bool Mine)** methods. This is an overloaded methood that takes in the following : the parts, Mine, parameter(optional);
``` c#
public Main()
{
YoutubeClient youtubeClient = new YoutubeClient(ApiKey, token);
PlaylistResponse Playlists = await youtubeClient.playlistsList.getPlaylistAsync(new string[] { "snippet" }, true);
}
```
And then you could do
``` c#
Parameter[] parameter = {new Parameter("prettyPrint", "true"), new Parameter("alt", "json")};
PlaylistResponse Playlists = await youtubeClient.playlistsList.getPlaylistAsync(new string[] { "snippet" }, true, parameter);
```
## Delete playlists
``` c#
string id="playlist_id";
var response = await youtubeClient.playlistsList.deletePlaylistAsync(id);
```
## Insert playlists
To insert a playlist you call the overloaded insertPlaylistAsync Methods
``` c#
PlaylistResponse playlist = await youtubeClient.playlistsList.insertPlaylistAsync("playlistTitle", "Description", new string[] { "snippet" });
```
You could optionally add parameters
``` c#
PlaylistResponse playlist = await youtubeClient.playlistsList.insertPlaylistAsync("playlistTitle", "Description", new string[] { "snippet", }, parameter );
```
# Channels
## Search for a channel by channel name
``` c#
string channelName = "Google Developers";
ChannelResponse channelResponse = await youtubeClient.channel.searchByUsernameAsync(channelName);
```
## Search for a channel by channel id
``` c#
string id = "Channel_Id";
ChannelResponse channelResponse = await youtubeClient.channel.searchByIdAsync(id);
```
## Get your own channel
``` c#
ChannelResponse channelResponse = await youtubeClient.channel.getMyChannelAsync(true);
```
# AnyRequests
This method here can be used to make any sort of requests
``` c#
Task makeRequestAsync(Method method, string youtube, string resource, string stringParameter, Parameter[] parameter = null, List body = null)
```
Here you specify the HTTPMethod, the Http request(youtube), the resource, parameters and optionally, the body. The method returns the result as a HttpResponseMessage
``` c#
HttpResponseMessage result = await youtubeClient.anyRequest.makeRequestAsync(Method.GET, "https://youtube.googleapis.com/youtube/v3/", "playlists?", "part=snippet&part=contentDetails&mine=true");
```
OR
``` c#
HttpResponseMessage result = await youtubeClient.anyRequest.makeRequestAsync(Method.GET, "https://youtube.googleapis.com/youtube/v3/", "playlists?", "", new Parameter[]{new Parameter("part","contentDetatils")});
```