「收賄」、「白手套」英文怎麼說?
Accept bribes? White gloves?
★★★★★★★★★★★★
《中華民國刑法》
Article 122
A public official or an arbitrator who demands, agrees to accept, or accepts a bribe or other improper benefits for a breach of his official duties shall be sentenced to imprisonment for not less than three years but not more than ten years; in addition thereto, a fine of not more than two million yuan may be imposed.
A breach of official duties shall be sentenced to life imprisonment or with imprisonment for not less than five years; in addition thereto, a fine not more than four million yuan may be imposed.
1. public official 公務員
2. arbitrator 仲裁人
3. accept a bribe 收受賄賂*
4. a breach of official duties 違背職務**
5. be sentenced 判處
6. imprisonment 監禁;關押
7. a fine 罰金
8. impose 強制實行
第 122 條
公務員或仲裁人對於違背職務之行為,要求、期約或收受賄賂或其他不正利益者,處三年以上十年以下有期徒刑,得併科二百萬元以下罰金。
因而為違背職務之行為者,處無期徒刑或五年以上有期徒刑,得併科四百萬元以下罰金。
全國法規資料庫: https://bit.ly/2Dk8Ia4
*bribery: https://bit.ly/31bwsFj
**breach: https://bit.ly/3k5qcHJ
★★★★★★★★★★★★
那「白手套」呢?
White gloves? Not really...
The term "white-glove" is typically used as an adjective. It means providing a very high level of service, or involving a lot of care about small details:
白手套(white-glove)通常用作形容詞。表示提供非常高的服務水準,或與諸多照護細節有關:
➣The cruise company does not want to risk alienating the other passengers who don't get the white-glove treatment.
郵輪公司不想冒險讓其他未接受白手套待遇的乘客變得疏遠。
➣We know that when extra attention is required, our white-glove delivery service will not disappoint.
當您有特殊要求,我們的白手套配送服務一定不會讓您失望。
—Cambridge Dictionary
https://bit.ly/3hZTw0r
Wait…that doesn't fit our context!
★★★★★★★★★★★★
According to the South China Morning Post, the expression “white gloves,” when used as a noun, was coined in Taiwan!
“The innocuous-sounding euphemism ‘white gloves’ generally refers to a middleman or outfit that launders dirty or corrupt money under a seemingly legitimate front - dirty hands concealed by a pair of white gloves. The expression, coined by the Taiwanese, is catching up fast on the mainland as rampant corruption is exposed at all levels of the bureaucracy.”
9. coin (v.) 創造(新詞或新的表達方式);首次使用(某一詞語)
10. innocuous-sounding 聽起來無害的
11. launder (v.) 洗(贓款) ; money laundering 洗錢
12. legitimate front 合法的地帶; 僞裝(人或機構的)僞裝;假裝的樣子
13. conceal 隱藏
14. catch up 了解(或討論)最新情況
15. rampant 猖獗的;蔓延的
16. bureaucracy 官僚體制;官僚主義
據《南華早報》的報導,「白手套」作為名詞的用法,首見於臺灣!
「聽起來無害的委婉用語『白手套』通常是指中間人或公司,他們在看似合法的地帶清洗髒錢或賄款——髒手則藏於白手套當中。這種由臺灣人首創的表達方式,正在中國迅速傳開,因為猖獗的腐敗現象已於官僚體制的各個層面暴露出來。」
詳見《SCMP》:https://bit.ly/3i2cqUA
★★★★★★★★★★★★
我個人會用「middleman」或「go-between」。
請注意,「middleman」是指批貨後轉售他人者,或協助他人安排商業交易者。該詞本身並不具有任何犯罪或不法行為等負面意涵(negative connotations),亦須有上下文才足以呈現「白手套」的概念。
另一方面,「go-between」是在雙方無法見面或不想見面時,將消息從一人(或一個團隊)傳給另一人(或另一個團隊)的人。例如,聯合國代表將充當兩國領導人的中間人(或掮客)——「go-between」,而它的搭配你可以用「act/serve as a go-between」。「go-between」 的一個同義詞是「intermediary」。
❖再次提醒各位,若缺乏前後文,這些用語就不能完全代表「白手套」的涵義。底下我將舉出一些在腐敗情況中所使用的例子。
★★★★★★★★★★★★
I. middleman
"Many of these middlemen stay on the right side of the law, offering advice and connections. But others cross the line. They grease the palms of officials and local managers, and they put a buffer between the payoff and the client, offering plausible deniability if the authorities catch on."
17. connections 社會關係;人際關係;可資利用的熟人
18. cross the line(行為)越過界線
19. grease (v.) 用油脂塗;給⋯⋯加潤滑油
20. buffer 緩衝物;起緩衝作用的人
21. payoff 賄款;遮口費
22. plausible deniability 合理推諉
「在這些中間人裡,有許多人站在法律這邊,提供建議與人脈。但其他人卻踰越了界線。他們成為官員與地方經理人的潤滑劑,並在賄款與委託人之間置入緩衝物,起到合理推諉的作用,以防當局上門。」
詳見《紐約時報》:https://nyti.ms/39MMwkM
★★★★★★★★★★★★
II. intermediary
"For China’s elite, a 'white glove' is an intermediary who launders your money; they handle the dirty deeds, while you keep your hands clean. 'White gloves' are often well-connected Westerners, such as former top politician Bo Xilai’s two European fixers, British businessman Neil Heywood and French architect Patrick Devillers. Using a BVI shell company, the two men helped Bo’s wife Gu Kalai buy a 7 million euro French mansion and rack up rental fees on it."
23. elite(社會)上層集團;掌權人物;出類拔萃的人;精英
24. deed(尤指很壞或很好的)事情;行為
25. well-connected 與顯貴人物有交情的;與有影響人士有來往的;很有背景的
26. fixer 籌謀者;安排者(尤指精於用不正當手段來操辦事情的人)
27. BVI (The British Virgin Islands) 英屬維京群島
28. shell company 空殼公司
29. fixer 安排者(尤指精於用不正當手段來操辦事情的人)
『對中國的權貴來說,「白手套」是幫你洗錢的中間人;他們負責處理骯髒的事,讓你的雙手保持乾淨。「白手套」通常是與權貴有交情的西方人士,例如前副國級領導人薄熙來的兩個歐洲籌謀者——英國商人海伍德以及法國建築師德維利耶。兩人藉由一家英屬維京群島的空殼公司,幫助薄的妻子谷開來買下一座價值700萬歐元的法式豪宅,並大大提高了租金。』
詳見《石英財經網》:https://bit.ly/30lFnEJ
★★★★★★★★★★★★
III. go-between
"The offence is similar to bribery with one important difference: trading in influence concerns the 'middleman', or the person that serves as the go-between the decision-maker and the party that seeks an improper advantage."
30. offence (US offense) 犯罪行為;罪行
31. bribery 賄賂
32. trade in influence 斡旋賄賂;影響力交易
33. serve(為⋯⋯)工作;(為⋯⋯)服務;盡職責
34. improper advantage 不當利益
『此一罪行與賄賂相似,但有一個重要的區別:斡旋賄賂係指「middleman」或人充當決策者與尋求不當利益方的中間人(掮客)——「go-between」』。
詳見 Anti-Corruption Resource Center:https://www.u4.no/terms
★★★★★★★★★★★★
歡迎在底下留言與我們分享更多相關字詞(例如:prosecutor、corruption charges、litigations⋯⋯)。
圖片出處: Google Image
★★★★★★★★★★★★
如果同學對於如何分析英文時事,以及如何進行批判性思考有興趣,歡迎加入我們的課程!
🌎國際新聞英文-六步驟思考術 | 最後優惠倒數 ► https://bit.ly/3eTHIvH
🌎國際新聞英文課程FAQ:https://wp.me/p44l9b-2lK
同時也有1部Youtube影片,追蹤數超過14萬的網紅Ricky英語小蛋糕,也在其Youtube影片中提到,6種必學other延伸用法【英文文法:others下集】Ricky//英語小蛋糕 | English Grammar: other/another 馬上領取 : https://lin.ee/oue8V3S (點進去後輸入教材密碼 r108) #英文教學#英文文法#ricky文法 🔔Youtu...
「other others用法」的推薦目錄:
- 關於other others用法 在 Eric's English Lounge Facebook
- 關於other others用法 在 尹俐 Julia Facebook
- 關於other others用法 在 玳瑚師父 Master Dai Hu Facebook
- 關於other others用法 在 Ricky英語小蛋糕 Youtube
- 關於other others用法 在 2022年6月號Unit 2 - one/another/other/others/the other 的用法 的評價
- 關於other others用法 在 速速辨認!other/others傻傻分不清?【英文文法(上)】Ricky ... 的評價
- 關於other others用法 在 YouTube Data API Overview - Google for Developers 的評價
other others用法 在 尹俐 Julia Facebook 八卦
會考戰士,加油!
這兩天,調整作息,再撐一下!
英文科文法重點提醒:
💡時態(特別注意過去式、過去進行式、現在完成式、過去完成式的用法差異,克漏字務必整篇判斷而非單句)
💡代名詞(特別注意one, ones, some, another, the other, others, it, there)
💡名詞子句、副詞子句(時態考題)、形容詞子句(特別注意關代省略)
💡動名詞、不定詞、祈使句
💡附加問句(三態同型的動詞是陷阱,have的用法)
💡連綴動詞、使役動詞、感官動詞、花費動詞
💡助動詞
💡疑問詞
💡被動語態
💡比較級、最高級
考試加油💪💪💪💪💪
other others用法 在 玳瑚師父 Master Dai Hu Facebook 八卦
《當心被鬼吃了》
Don't Get Eaten By The Ghosts!
(English version below)
時至今日,談鬼依然使人色變。多年前、吾收了一位對玄學及鬼神,又喜歡又害怕的美麗女子為徒。偶爾談起「無形」時,她會緊張地問吾,那裡有無「無形」?現在想起,是有點好笑。好笑於她那時的表情,與「無知」的迷糊。鬼神當然是「無形」的一類,若無結界,任何人的住宅,祂們都可以通行無阻。因此,妳你們的住處,肯定有鬼!
鬼神是佈滿十方法界的,鬼類和人類是沒有多大分別的。唯一的分別是,鬼類已脫離了肉身,而人類還未脫離肉身。鬼類屬低級靈,只要一個咒語、一個想念,就能攝招祂們來。就因如此,那些常圖非份的人,鋌而走險的請鬼、養鬼,好逸惡勞的想要不勞而獲。或許這些「歹徒」並不十分清楚,她他們所請所養的鬼,是和她他們一樣,貪念甚重的,且法力也會增長,會有不受約束的一天。若法力與符力不夠,她他們會被反噬。
過去吾是有幫人處理,被鬼類干擾之事。也曾有婦女欲請吾去其住宅捉鬼及收鬼。其實當時吾是有打算,去「會一會」她宅中的「小朋友」,可惜她接二連三的「做奸犯科」,更何況,她先生是請鬼的人,即不信也沒來請吾,此謂因緣不足也。夫婦倆的起心動念,倒是合了「鬼性」,是問吾如何捉得完,收得完。有可能她他們目前宅中的鬼,會幫她他阻止其他鬼進來也說不一定!哈 哈 哈!
鬼類與人類本來就有界限的。有如井水不犯河水。但因妳你用法術去攝招祂們來,從此祂們就一直跟著妳你。再加上妳你所差遣祂們去辦的事,皆屬惡行的話,妳你身上的鬼氣會越來越重,最終將輪迴的鬼處。拜師又叛師,起心動念皆不敬師、受人恩惠不圖報、貪得無厭、喜佔她他人便宜、辱罵佛菩薩神明,等等等,鬼就每天愛妳你多一些。日寫夜也寫,以文章的慧光照妳你們,希望妳你們正心正念,那就不用當心被鬼吃了。
⋯⋯⋯⋯⋯⋯⋯
Even till this modern age, the reaction when the word ghost is being brought up remains that of an ashen look on the face. Many years ago, I took in a beautiful lady, as my disciple. She has a deep fascination (and fear) of all things Metaphysics and spiritual. Whenever we spoke about the spirits, she would nervously ask me if there was any around her. It always amuses me whenever I recall those conversations with her. It was amusing because of her facial expressions and the look of ignorance. Of course, spirits are without any physical forms, and it is free access for them if no demarcation is done at a house. Therefore I am sure there are spirits in your house!
Spirits are everywhere in the ten realms of existence, and there is not much difference between us humans and the spirits. The only difference lies in their lack of physical form. These ghosts belong to a lower realm, and can be easily summoned by a mantra or a thought.
There are people with wayward intentions, who take the huge risk to summon the spirits and make offering to them, so that the spirits will do their bidding. Maybe they have no idea that the spirits they summoned are like them, with insatiable greed, as that they grow in strength.
These spirits will break free one day, if the powers of the owner and his talismans are unable to contain them. When that happens, the people who summoned them will get devoured instead.
In the past, I had dealt with cases of spiritual disturbance. One female client invited me to visit her house for some ghost-busting. I did have the initial intention to meet the "little friend" in her home, but changed my mind after knowing her bad doings. Her husband was the one who "invited" the ghost for his own gains, and he did not believe in me to invite me personally. Therefore, the affinity is weak.
The thoughts and intentions of this couple matches that of a spirit, so how could I succeed in driving the ghost out? Who knows, this ghost might be able to prevent other spirits from intruding their house! Ha ha ha!
There is a boundary between humans and spirits, just like the water in the well does not cross the path of the water on the river. However, if you summon a spirit via spiritual invocation, it will stick with you forever. The ghostly energy in you will only perpetuate if you command the spirit to help you in wrongdoings.
In the end upon your death, you will be reincarnated in the realm of ghosts. Behavior like disrespect and betrayal of your master, being ungrateful to your benefactors, insatiable greed, taking advantage of others, cursing at the gods and Buddhas, etc, will only make the spirits "love" you more! I write relentlessly day and night, so that the Light of Wisdom will shine on you and inspire righteous and wholesome intentions. Then you would not need to worry being "eaten" alive by the spirits.
www.masterdaihu.com/dont-get-eaten-by-the-ghosts/
Photo credit: Casper Movie
other others用法 在 Ricky英語小蛋糕 Youtube 的評價
6種必學other延伸用法【英文文法:others下集】Ricky//英語小蛋糕 | English Grammar: other/another
馬上領取 : https://lin.ee/oue8V3S
(點進去後輸入教材密碼 r108)
#英文教學#英文文法#ricky文法
🔔Youtube 訂閱 https://bit.ly/2qrtE53
🔔IG 追蹤 http://bit.ly/2HVjpQn
🔔line@ 追蹤 http://bit.ly/2U2Q1yH
----------------------------------------------------------------------
延伸閱讀:【other用法(上集)】https://youtu.be/hFVtDdE77OU
看完上次的留言,大家真的是被other這個搞怪的傢伙搞得頭混腦脹🤣
今天教你們other延伸的6種用法!!
且慢不要轉台啊~~其實超簡單分辨的
跟著Ricky一起學文法吧🥰
英文文法
【感官型連綴動詞,look是一般動詞還是連綴動詞?】https://youtu.be/PhYo_Ae97Ro
【秒判斷單字詞性,易混淆的單字詞性】https://youtu.be/gvWetfXviTw
【名詞子句(上)】https://youtu.be/e_fzzCnJ_go
熱門影片
【去語言學校英文真的會變好? 菲律賓語言學校推薦】https://youtu.be/bHEGfcP3jkc
多益高分系列
【多益高分7個必懂文法 】https://youtu.be/Os3eFKisucw
【新制多益8個必懂考前秘訣】多益990教我的事https://youtu.be/GkMkQ4I91uI
航空系列(考空服員\地勤)
【航空面試NG回答!一定不要這樣說】https://youtu.be/WvmyP2n1NyU
【第二關:角色扮演role play】https://youtu.be/UIXzsA6y0F0
實用英文系列
【超實用!職場必學五句片語】Ricky//英語小蛋糕https://youtu.be/Nj6ZfMODV2U
【完勝檢定!五種實用工具 輕鬆對付 聽說讀寫!】https://youtu.be/eVFGyS0QuA0
【一秒變外國人!增進聽力7大連音規則】https://youtu.be/9VYaHa4lwtA
來賓爆笑挑戰系列
【超爆笑聽力大考驗,熱門歌曲歌詞猜一猜】https://youtu.be/-LxlvkbDna0
【猜謎大亂鬥!英文片語猜猜看】https://youtu.be/Ri-fFz5Q-mI
我在AmazingTalker開課囉!
包含基本的生活會話,還有航空英文、商業英文
甚至是檢定英文,都可以來看看唷!
如果有其他英文需求也可以在頁面私訊我!
來我的教師頁面看看吧:
http://bit.ly/2WsxXvB
合作邀約 ricky@amazingtalker.com
每週四晚上8:00準時發布影片哦!
不定時週二晚上8:00發布有趣生活影片~
----------------------------------------------------------------------
Facebook 第一手看到訊息歡迎來按讚 + 搶先看
傳送門: https://goo.gl/R2DTW5
AmazingTalker 線上語言教學剪輯團隊
傳送門: https://goo.gl/LewJuV

other others用法 在 速速辨認!other/others傻傻分不清?【英文文法(上)】Ricky ... 的八卦

速速辨認! other / others 傻傻分不清?【英文文法(上)】Ricky//英語小蛋糕| English Grammar: other / another ‼️「講義教材」領取截止‼️ ... <看更多>
other others用法 在 YouTube Data API Overview - Google for 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
activity
Contains 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.
channel
Contains information about a single YouTube channel.
channelBanner
Identifies the URL to use to set a newly uploaded image as the banner image for a channel.
channelSection
Contains 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.
guideCategory
Identifies 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.
i18nLanguage
Identifies an application language that the YouTube website supports. The application language can also be referred to as a UI language.
i18nRegion
Identifies 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.
playlist
Represents a single YouTube playlist. A playlist is a collection of videos that can be viewed sequentially and shared with other users.
playlistItem
Identifies 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 result
Contains 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.
subscription
Contains 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.
thumbnail
Identifies thumbnail images associated with a resource.
video
Represents a single YouTube video.
videoCategory
Identifies a category that has been or could be associated with uploaded videos.
watermark
Identifies 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 playlistItem
resource's snippet.resourceId.videoId
property identifies a video resource that, in turn, contains complete information about the video. As another example, a search result contains either a videoId
, playlistId
, or channelId
property 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.rate
method associates a user rating with a video, and the thumbnails.set
method uploads a video thumbnail image to YouTube and associates it with a video.
Operations
list
Retrieves (
GET
) a list of zero or more resources.insert
Creates (
POST
) a new resource.update
Modifies (
PUT
) an existing resource to reflect data in your request.delete
Removes (
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, list
methods 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
activity
caption
channel
channelBanner
channelSection
comment
commentThread
guideCategory
i18nLanguage
i18nRegion
playlist
playlistItem
search result
subscription
thumbnail
video
videoCategory
watermark
Quota 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
completing 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
50
units.A search request costs
100
units.A video upload costs
1600
units.The Quota costs for API requests table shows the
quota 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.
The part
parameter identifies groups of properties that should be returned for a resource.
The fields
parameter filters the API response to only return specific properties within the requested resource parts.
part
parameterThe part
parameter 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, a video
resource has the following parts:
snippet
contentDetails
fileDetails
player
processingDetails
recordingDetails
statistics
status
suggestions
topicDetails
All 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 part
parameter 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 thefields
parameterThe fields
parameter filters the API response, which only contains the resource parts identified in the part
parameter value, so that the response only includes a specific set of fields. The fields
parameter lets you remove nested properties from an API response and thereby further reduce your bandwidth usage. (The part
parameter cannot be used to filter nested properties from a response.)
The following rules explain the supported syntax for the fields
parameter 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 fields
parameter 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/position
fields=items(id,snippet/title,snippet/position)
fields=items(id,snippet(title,position))
Note: As with all query parameter values, the fields
parameter 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 part
and fields
parameters 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
kind
and etag
properties.Example 2 returns a video resource that includes two parts as well as
kind
and etag
properties.Example 3 returns a video resource that includes two parts but excludes
kind
and etag
properties.Example 4 returns a video resource that includes two parts but excludes
kind
and etag
as well as some nested properties in the resource's snippet
object.Example 1
URL: https://www.googleapis.com/youtube/v3/videos?id=7lCDEYXw3mM&key=YOUR_API_KEY
&part=snippet,contentDetails,statistics,statusDescription: This example retrieves avideo
resource and identifies several
resource parts that should be included in the API response.API response:
{
"kind": "youtube#videoListResponse",
"etag": "\"UCBpFjp2h75_b92t44sqraUcyu0/sDAlsG9NGKfr6v5AlPZKSEZdtqA\"",
"videos": [
{
"id": "7lCDEYXw3mM",
"kind": "youtube#video",
"etag": "\"UCBpFjp2h75_b92t44sqraUcyu0/iYynQR8AtacsFUwWmrVaw4Smb_Q\"",
"snippet": {
"publishedAt": "2012-06-20T22:45:24.000Z",
"channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
"title": "Google I/O 101: Q&A On Using Google APIs",
"description": "Antonio Fuentes speaks to us and takes questions on working with Google APIs and OAuth 2.0.",
"thumbnails": {
"default": {
"url": "https://i.ytimg.com/vi/7lCDEYXw3mM/default.jpg"
},
"medium": {
"url": "https://i.ytimg.com/vi/7lCDEYXw3mM/mqdefault.jpg"
},
"high": {
"url": "https://i.ytimg.com/vi/7lCDEYXw3mM/hqdefault.jpg"
}
},
"categoryId": "28"
},
"contentDetails": {
"duration": "PT15M51S",
"aspectRatio": "RATIO_16_9"
},
"statistics": {
"viewCount": "3057",
"likeCount": "25",
"dislikeCount": "0",
"favoriteCount": "17",
"commentCount": "12"
},
"status": {
"uploadStatus": "STATUS_PROCESSED",
"privacyStatus": "PRIVACY_PUBLIC"
}
}
]
}
Example 2
URL: https://www.googleapis.com/youtube/v3/videos?id=7lCDEYXw3mM&key=YOUR_API_KEY
&part=snippet,statisticsDescription: This example modifies thepart
parameter value so that the
contentDetails
andstatus
properties are not included
in the response.API response:
{
"kind": "youtube#videoListResponse",
"etag": "\"UCBpFjp2h75_b92t44sqraUcyu0/sDAlsG9NGKfr6v5AlPZKSEZdtqA\"",
"videos": [
{
"id": "7lCDEYXw3mM",
"kind": "youtube#video",
"etag": "\"UCBpFjp2h75_b92t44sqraUcyu0/iYynQR8AtacsFUwWmrVaw4Smb_Q\"",
"snippet": {
"publishedAt": "2012-06-20T22:45:24.000Z",
"channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
"title": "Google I/O 101: Q&A On Using Google APIs",
"description": "Antonio Fuentes speaks to us and takes questions on working with Google APIs and OAuth 2.0.",
"thumbnails": {
"default": {
"url": "https://i.ytimg.com/vi/7lCDEYXw3mM/default.jpg"
},
"medium": {
"url": "https://i.ytimg.com/vi/7lCDEYXw3mM/mqdefault.jpg"
},
"high": {
"url": "https://i.ytimg.com/vi/7lCDEYXw3mM/hqdefault.jpg"
}
},
"categoryId": "28"
},
"statistics": {
"viewCount": "3057",
"likeCount": "25",
"dislikeCount": "0",
"favoriteCount": "17",
"commentCount": "12"
}
}
]
}
Example 3
URL: https://www.googleapis.com/youtube/v3/videos?id=7lCDEYXw3mM&key=YOUR_API_KEY
&part=snippet,statistics&fields=items(id,snippet,statistics)Description: This example adds thefields
parameter to remove all
kind
andetag
properties from the API response.API response:
{
"videos": [
{
"id": "7lCDEYXw3mM",
"snippet": {
"publishedAt": "2012-06-20T22:45:24.000Z",
"channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
"title": "Google I/O 101: Q&A On Using Google APIs",
"description": "Antonio Fuentes speaks to us and takes questions on working with Google APIs and OAuth 2.0.",
"thumbnails": {
"default": {
"url": "https://i.ytimg.com/vi/7lCDEYXw3mM/default.jpg"
},
"medium": {
"url": "https://i.ytimg.com/vi/7lCDEYXw3mM/mqdefault.jpg"
},
"high": {
"url": "https://i.ytimg.com/vi/7lCDEYXw3mM/hqdefault.jpg"
}
},
"categoryId": "28"
},
"statistics": {
"viewCount": "3057",
"likeCount": "25",
"dislikeCount": "0",
"favoriteCount": "17",
"commentCount": "12"
}
}
]
}
Example 4
URL: https://www.googleapis.com/youtube/v3/videos?id=7lCDEYXw3mM&key=YOUR_API_KEY
&fields=items(id,snippet(channelId,title,categoryId),statistics)&part=snippet,statisticsDescription: This example modifies thefields
parameter from example 3
so that in the API response, each video resource'ssnippet
object only includes thechannelId
,title
,
andcategoryId
properties.API response:
{
"videos": [
{
"id": "7lCDEYXw3mM",
"snippet": {
"channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
"title": "Google I/O 101: Q&A On Using Google APIs",
"categoryId": "28"
},
"statistics": {
"viewCount": "3057",
"likeCount": "25",
"dislikeCount": "0",
"favoriteCount": "17",
"commentCount": "12"
}
}
]
}
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-Match
and If-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-Match
and If-None-Match
HTTP 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-Encoding
HTTP request header to gzip
.
Modify your user agent to contain the string gzip
.
The sample HTTP headers below demonstrate these requirements for enabling gzip compression:
Accept-Encoding: gzip
User-Agent: my program (gzip)
... <看更多>
other others用法 在 2022年6月號Unit 2 - one/another/other/others/the other 的用法 的八卦
A+ English空中美語雜誌訂閱:http://shop.english4u.net加入我們的粉絲團:https://www.facebook.com/AMCAplusEnglish/想要A+ English空中美語雜誌 ... ... <看更多>