⭐️五月是美國亞太裔傳統月！美國亞太裔外交官在美國國務院扮演重要的角色，在AIT的運作上更是如此！在整個五月份，我們將為各位介紹AIT亞太裔官員的重要貢獻。今天要和大家介紹的是政治組官員黃東偉(Tom Wong)的故事。
✨在我外派來台期間，我最難忘的回憶莫過於有幸受邀至台中女中演講，台中女中正是我媽媽50多年前畢業的母校。我媽媽畢業不久之後便離開台灣，最終定居美國，並在當地認識了我爸爸，而我爸爸則是早了幾年移民美國。我和我弟弟在紐澤西長大時，我媽媽就常常教我們一句中文俗諺：「吃得苦中苦，方爲人上人」。就像許多新移民一樣，我父母一生中也經歷了不少艱辛與磨難，但他們最後都成為美國社會富有貢獻的一份子。而當我努力奮鬥，希望讓我的家人和國家為我感到驕傲時，我從來沒有忘記這句媽媽教過我的話。誰又想的到，在我媽媽離開台灣、又過了一代之後，她在美國出生的兒子會加入美國陸軍的行列，隨後成為美國外交官，甚至有機會回到媽媽的母校去拜訪。- AIT政治組官員黃東偉
*黃東偉曾獲選為「40位美國亞太裔國家安全及外交政策下一代領袖人物」！回顧一下: https://bit.ly/2QWWT0r #AAPIHeritageMonth
⭐️It’s Asian-American and Pacific Islander Heritage Month! AAPI diplomats are a vital part of the State Department, and especially our AIT operation! All month, we look forward to featuring the important contributions of our AAPI colleagues. Today we are sharing Political Section Officer Tom Wong’s story with you.
✨One of my most unforgettable moments during my tour in Taiwan was having the honor of speaking at the Taichung Girls Senior High School, where my mother graduated over 50 years ago. Shortly after graduating, my mom left Taiwan and eventually settled in the United States, where she met my father, who himself had immigrated several years prior. When my brother and I were growing up in New Jersey, she taught us the Chinese phrase "吃得苦中苦，方爲人上人” (loosely translated as "no pain, no gain"). Like countless other immigrants to the United States, my parents endured their fair share of hardships in their lifetime, yet emerged to become productive members of American society. In my own efforts to make my family and country proud, I've never forgotten that phrase my mom taught me. Who would have thought that a generation after my mom left Taiwan, her American born son would go on to serve in the U.S. Army, then join the U.S. diplomatic corps, and have the opportunity to return to visit the very institution that educated her in her youth. -- Political Section Officer Tom Wong
*Tom Wong was recognized as one of the "40 Asian American Pacific Islander National Security & Foreign Policy Next Generation Leaders." See the post: https://bit.ly/2QWWT0r
loosely中文 在 YouTube Data API Overview | Google Developers 的推薦與評價
Introduction
This document is intended for developers who want to write applications that interact with YouTube. It explains basic concepts of YouTube and of the API itself. It also provides an overview of the different functions that the API supports.
Before you startYou need a Google Account to access the Google API Console, request an API key, and register your application.
Create a project in the Google Developers Console and obtain authorization credentials so your application can submit API requests.
After creating your project, make sure the YouTube Data API is one of the services that your application is registered to use:
Go to the API Console and select the project that you just registered.
Visit the Enabled APIs page.
In the list of APIs, make sure the status is ON for the YouTube Data API v3.
If your application will use any API methods that require user authorization, read the authentication guide to learn how to implement OAuth 2.0 authorization.
Select a client library to simplify your API implementation.
Familiarize yourself with the core concepts of the JSON (JavaScript Object Notation) data format. JSON is a common, language-independent data format that provides a simple text representation of arbitrary data structures. For more information, see json.org.
Resources and resource types
A resource is an individual data entity with a unique identifier. The table below describes the different types of resources that you can interact with using the API.
Resources
activityContains information about an action that a particular user has taken on the YouTube site. User actions that are reported in activity feeds include rating a video, sharing a video, marking a video as a favorite, and posting a channel bulletin, among others.
channelContains information about a single YouTube channel.
channelBannerIdentifies the URL to use to set a newly uploaded image as the banner image for a channel.
channelSectionContains information about a set of videos that a channel has chosen to feature. For example, a section could feature a channel's latest uploads, most popular uploads, or videos from one or more playlists.
guideCategoryIdentifies a category that YouTube associates with channels based on their content or other indicators, such as popularity. Guide categories seek to organize channels in a way that makes it easier for YouTube users to find the content they're looking for. While channels could be associated with one or more guide categories, they are not guaranteed to be in any guide categories.
i18nLanguageIdentifies an application language that the YouTube website supports. The application language can also be referred to as a UI language.
i18nRegionIdentifies a geographic area that a YouTube user can select as the preferred content region. The content region can also be referred to as a content locale.
playlistRepresents a single YouTube playlist. A playlist is a collection of videos that can be viewed sequentially and shared with other users.
playlistItemIdentifies a resource, such as a video, that is part of a playlist. The playlistItem resource also contains details that explain how the included resource is used in the playlist.
search resultContains information about a YouTube video, channel, or playlist that matches the search parameters specified in an API request. While a search result points to a uniquely identifiable resource, like a video, it does not have its own persistent data.
subscriptionContains information about a YouTube user subscription. A subscription notifies a user when new videos are added to a channel or when another user takes one of several actions on YouTube, such as uploading a video, rating a video, or commenting on a video.
thumbnailIdentifies thumbnail images associated with a resource.
videoRepresents a single YouTube video.
videoCategoryIdentifies a category that has been or could be associated with uploaded videos.
watermarkIdentifies an image that displays during playbacks of a specified channel's videos. The channel owner can also specify a target channel to which the image links as well as timing details that determine when the watermark appears during video playbacks and then length of time it is visible.
Note that, in many cases, a resource contains references to other resources. For example, a
Supported operationsplaylistItemresource'ssnippet.resourceId.videoIdproperty identifies a video resource that, in turn, contains complete information about the video. As another example, a search result contains either avideoId,playlistId, orchannelIdproperty that identifies a particular video, playlist, or channel resource.The following table shows the most common methods that the API supports. Some resources also support other methods that perform functions more specific to those resources. For example, the
videos.ratemethod associates a user rating with a video, and thethumbnails.setmethod uploads a video thumbnail image to YouTube and associates it with a video.Operations
listRetrieves (
GET) a list of zero or more resources.insertCreates (
POST) a new resource.updateModifies (
PUT) an existing resource to reflect data in your request.deleteRemoves (
DELETE) a specific resource.The API currently supports methods to list each of the supported resource types, and it supports write operations for many resources as well.
The table below identifies the operations that are supported for different types of resources. Operations that insert, update, or delete resources always require user authorization. In some cases,
listmethods support both authorized and unauthorized requests, where unauthorized requests only retrieve public data while authorized requests can also retrieve information about or private to the currently authenticated user.Supported Operations
list
insert
update
delete
activitycaptionchannelchannelBannerchannelSectioncommentcommentThreadguideCategoryi18nLanguagei18nRegionplaylistplaylistItemsearch resultsubscriptionthumbnailvideovideoCategorywatermarkQuota usage
The YouTube Data API uses a quota to ensure that developers use the service as intended and do not create applications that unfairly reduce service quality or limit access for others. All API requests, including invalid requests, incur at least a one-point quota cost. You can find the quota available to your application in the API Console.
Projects that enable the YouTube Data API have a default quota allocation of 10,000 units per day, an amount sufficient for the overwhelming majority of our API users. Default quota, which is subject to change, helps us optimize quota allocations and scale our infrastructure in a way that is more meaningful to our API users. You can see your quota usage on the Quotas page in the API Console.
Note: If you reach the quota limit, you can request additional quota by
Calculating quota usagecompleting the Quota extension
request form for YouTube API Services.
Google calculates your quota usage by assigning a cost to each request. Different types of
operations have different quota costs. For example:
A read operation that retrieves a list of resources -- channels, videos, playlists -- usually
costs 1 unit.
A write operation that creates, updates, or deletes a resource usually has costs
50units.A search request costs
100units.A video upload costs
1600units.The Quota costs for API requests table shows the
Partial resourcesquota cost of each API method. With these rules in mind, you can estimate the number of requests
that your application could send per day without exceeding your quota.
The API allows, and actually requires, the retrieval of partial resources so that applications avoid transferring, parsing, and storing unneeded data. This approach also ensures that the API uses network, CPU, and memory resources more efficiently.
The API supports two request parameters, which are explained in the following sections, that enable you to identify the resource properties that should be included in API responses.
How to use theThe
partparameter identifies groups of properties that should be returned for a resource.The
fieldsparameter filters the API response to only return specific properties within the requested resource parts.partparameterThe
partparameter is a required parameter for any API request that retrieves or returns a resource. The parameter identifies one or more top-level (non-nested) resource properties that should be included in an API response. For example, avideoresource has the following parts:snippetcontentDetailsfileDetailsplayerprocessingDetailsrecordingDetailsstatisticsstatussuggestionstopicDetailsAll of these parts are objects that contain nested properties, and you can think of these objects as groups of metadata fields that the API server might (or might not) retrieve. As such, the
partparameter requires you to select the resource components that your application actually uses. This requirement serves two key purposes:It reduces latency by preventing the API server from spending time retrieving metadata fields that your application doesn't use.
It reduces bandwidth usage by reducing (or eliminating) the amount of unnecessary data that your application might retrieve.
Over time, as resources add more parts, these benefits will only increase since your application will not be requesting newly introduced properties that it doesn't support.
How to use thefieldsparameterThe
fieldsparameter filters the API response, which only contains the resource parts identified in thepartparameter value, so that the response only includes a specific set of fields. Thefieldsparameter lets you remove nested properties from an API response and thereby further reduce your bandwidth usage. (Thepartparameter cannot be used to filter nested properties from a response.)The following rules explain the supported syntax for the
fieldsparameter value, which is loosely based on XPath syntax:Use a comma-separated list (
fields=a,b) to select multiple fields.Use an asterisk (
fields=*) as a wildcard to identify all fields.Use parentheses (
fields=a(b,c)) to specify a group of nested properties that will be included in the API response.Use a forward slash (
fields=a/b) to identify a nested property.In practice, these rules often allow several different
fieldsparameter values to retrieve the same API response. For example, if you want to retrieve the playlist item ID, title, and position for every item in a playlist, you could use any of the following values:fields=items/id,playlistItems/snippet/title,playlistItems/snippet/positionfields=items(id,snippet/title,snippet/position)fields=items(id,snippet(title,position))Note: As with all query parameter values, the
Sample partial requestsfieldsparameter value must be URL encoded. For better readability, the examples in this document omit the encoding.The examples below demonstrate how you can use the
partandfieldsparameters to ensure that API responses only include the data that your application uses:Example 1 returns a video resource that includes four parts as well as
kindandetagproperties.Example 2 returns a video resource that includes two parts as well as
kindandetagproperties.Example 3 returns a video resource that includes two parts but excludes
kindandetagproperties.Example 4 returns a video resource that includes two parts but excludes
kindandetagas well as some nested properties in the resource'ssnippetobject.Example 1
Example 2
Example 3
Example 4
Optimizing performance
Using ETags
ETags, a standard part of the HTTP protocol, allow applications to refer to a specific version of a particular API resource. The resource could be an entire feed or an item in that feed. This functionality supports the following use cases:
Caching and conditional retrieval – Your application can cache API resources and their ETags. Then, when your application requests a stored resource again, it specifies the ETag associated with that resource. If the resource has changed, the API returns the modified resource and the ETag associated with that version of the resource. If the resource has not changed, the API returns an HTTP 304 response (
Not Modified), which indicates that the resource has not changed. Your application can reduce latency and bandwidth usage by serving cached resources in this manner.The client libraries for Google APIs differ in their support of ETags. For example, the JavaScript client library supports ETags via a whitelist for allowed request headers that includes
If-MatchandIf-None-Match. The whitelist allows normal browser caching to occur so that if a resource's ETag has not changed, the resource can be served from the browser cache. The Obj-C client, on the other hand, does not support ETags.Protecting against inadvertent overwrites of changes – ETags help to ensure that multiple API clients don't inadvertently overwrite each other's changes. When updating or deleting a resource, your application can specify the resource's ETag. If the ETag doesn't match the most recent version of that resource, then the API request fails.
Using ETags in your application provides several benefits:
The API responds more quickly to requests for cached but unchanged resources, yielding lower latency and lower bandwidth usage.Your application will not inadvertently overwrite changes to a resource that were made from another API client.
The Google APIs Client Library for JavaScript supports
If-MatchandIf-None-MatchHTTP request headers, thereby enabling ETags to work within the context of normal browser caching.Using gzip
You can also reduce the bandwidth needed for each API response by enabling gzip compression. While your application will need additional CPU time to uncompress API responses, the benefit of consuming fewer network resources usually outweighs that cost.
To receive a gzip-encoded response you must do two things:
Set the
Accept-EncodingHTTP request header togzip.Modify your user agent to contain the string
gzip.The sample HTTP headers below demonstrate these requirements for enabling gzip compression:
... <看更多>