บริการ API ของ YouTube - ฟังก์ชันการทำงานขั้นต่ำที่จำเป็น

หมายเหตุ: การปฏิบัติตามนโยบายสำหรับนักพัฒนาแอปของ YouTube จะมีคำแนะนำและตัวอย่างที่จะช่วยให้คุณมั่นใจได้ว่าไคลเอ็นต์ API ของคุณจะปฏิบัติตามส่วนที่เฉพาะเจาะจงของข้อกำหนดและนโยบายของบริการ API ของ YouTube (ข้อกำหนดในการให้บริการของ API) คู่มือนี้จะให้ข้อมูลเชิงลึกเกี่ยวกับวิธีที่ YouTube บังคับใช้ข้อกำหนดในการให้บริการของ API ในบางแง่มุม แต่ไม่ได้แทนที่เอกสารที่มีอยู่

เอกสารนี้กำหนดข้อกำหนดด้านฟังก์ชันการทำงานขั้นต่ำสำหรับไคลเอ็นต์ API ที่ใช้หรือให้สิทธิ์เข้าถึงฟีเจอร์ที่เฉพาะเจาะจงของบริการ API ของ YouTube ("ไคลเอ็นต์ API")

ข้อกำหนดและหลักเกณฑ์เหล่านี้ช่วยให้มั่นใจได้ว่าไคลเอ็นต์ API จะมอบประสบการณ์การใช้งานที่สอดคล้องกันซึ่งปกป้องผลประโยชน์ของผู้ใช้ YouTube, เจ้าของเนื้อหา และผู้ลงโฆษณา กฎเหล่านี้เป็นส่วนหนึ่งของข้อกำหนดในการให้บริการของ YouTube API และต้องปฏิบัติตามในการพัฒนาและใช้งานไคลเอ็นต์ API

คุณควรคาดหวังว่าข้อกำหนดในเอกสารนี้จะมีการเปลี่ยนแปลงเพื่อให้เรามั่นใจได้ว่าผู้ใช้จะได้รับประสบการณ์การใช้งานฟีเจอร์ที่มีอยู่ของ YouTube ที่ดียิ่งขึ้น นอกจากนี้ ข้อกำหนดเหล่านี้จะมีการเปลี่ยนแปลงตามฟีเจอร์ใหม่และฟีเจอร์ที่อัปเดตของ YouTube ด้วย ในบางครั้ง การเปลี่ยนแปลงดังกล่าวอาจกำหนดให้คุณต้องอัปเดตไคลเอ็นต์ API เพื่อให้เป็นไปตามข้อกำหนดใหม่ ประวัติการแก้ไขข้อกำหนดในการให้บริการจะบันทึกการเปลี่ยนแปลงทั้งหมด ดังนั้นโปรดตรวจสอบเอกสารดังกล่าวบ่อยๆ หรือสมัครรับฟีด RSS เพื่อให้มั่นใจว่าคุณจะทราบการเปลี่ยนแปลงที่อาจส่งผลต่อไคลเอ็นต์ API ได้อย่างรวดเร็ว

นอกเหนือจากข้อกำหนดในเอกสารนี้ เราขอแนะนำเป็นอย่างยิ่งให้คุณปฏิบัติตามแนวทางปฏิบัติแนะนำที่อธิบายไว้ในนโยบายบริการ API ของ YouTube และที่กล่าวถึงในส่วนอื่นๆ ของเอกสารประกอบของบริการ YouTube API แม้ว่าจะไม่จำเป็นอย่างเคร่งครัด แต่แนวทางปฏิบัติเหล่านี้จะช่วยให้ไคลเอ็นต์ API กู้คืนจากข้อผิดพลาดได้เร็วขึ้น และเพิ่มประสิทธิภาพการใช้งานโควต้าหากใช้บริการ API ของ YouTube ที่จัดสรรโควต้า ในขณะเดียวกัน แนวทางปฏิบัติเหล่านี้ยังช่วยให้มั่นใจได้ถึงความสมบูรณ์ของระบบนิเวศของ YouTube และเหนือสิ่งอื่นใดคือการมอบประสบการณ์การใช้งานที่ดีที่สุดเท่าที่จะเป็นไปได้แก่ผู้ใช้ไคลเอ็นต์ API และแอปพลิเคชัน YouTube ของคุณ

วิดีโอเพลเยอร์ของ YouTube ที่ฝังไว้และการเล่นวิดีโอ

ข้อกำหนดในส่วนนี้เกี่ยวข้องกับวิดีโอเพลเยอร์ของ YouTube ที่ฝังไว้โดยเฉพาะ นโยบายบริการ API ของ YouTube ยังรวมถึงนโยบายหลายข้อที่เกี่ยวข้องกับไคลเอ็นต์ API ที่เล่นเนื้อหาภาพและเสียงของ YouTube

ข้อมูลประจำตัวและข้อมูลเข้าสู่ระบบของไคลเอ็นต์ API

ไคลเอ็นต์ API ที่ใช้เพลเยอร์แบบฝังของ YouTube (รวมถึง YouTube IFrame Player API) ต้องระบุตัวตนผ่านส่วนหัวคำขอ HTTP Referer ในบางสภาพแวดล้อม เบราว์เซอร์จะตั้งค่า HTTP Referer โดยอัตโนมัติ และไคลเอ็นต์ API เพียงแค่ต้องตรวจสอบว่าไม่ได้ตั้งค่า Referrer-Policy ในลักษณะที่ระงับค่า Referer YouTube ขอแนะนำให้ใช้ strict-origin-when-cross-originReferrer-Policy ซึ่งเป็นค่าเริ่มต้นในเบราว์เซอร์หลายๆ รายการอยู่แล้ว

ในทำนองเดียวกัน หากผสานรวมโปรแกรมเล่น YouTube ที่ฝังในหน้าต่างที่สร้างขึ้นโดยใช้ JavaScript window.open ไคลเอ็นต์ API จะต้องไม่ใช้ฟีเจอร์ noreferrer ซึ่งจะระงับค่า Referer

ตั้งค่า Referer

ในสภาพแวดล้อมที่ HTTP Referer ว่างเปล่าโดยค่าเริ่มต้นและเบราว์เซอร์ไม่ได้ตั้งค่าโดยอัตโนมัติ ไคลเอ็นต์ API ต้องดำเนินการเพื่อระบุตัวตนผ่านวิธีการอื่น ในการผสานรวม WebView เช่น แอปบนอุปกรณ์เคลื่อนที่หรือแอปบนเดสก์ท็อป HTTP Referer จะว่างเปล่าโดยค่าเริ่มต้น และโดยปกติแล้ว Referer จะตั้งค่าโดยใช้เทคนิคใดเทคนิคหนึ่งต่อไปนี้

• แอปบนอุปกรณ์เคลื่อนที่มีเพลเยอร์อยู่ภายในไฟล์ HTML ในเครื่อง

  ในการกำหนดค่านี้ ระบบจะโหลดเพลเยอร์ในไฟล์ HTML ที่รวมอยู่ในแอป เมื่อโหลดไฟล์ HTML นี้ การตั้งค่าพารามิเตอร์ baseUrl จะตั้งค่า Referer

  • Android loadDataWithBaseURL
  • iOS loadHTMLString:baseURL:

• แอปบนอุปกรณ์เคลื่อนที่ที่ไม่มีไฟล์ HTML ในเครื่อง

  ในการกำหนดค่านี้ ระบบจะโหลดเพลเยอร์จาก https://www.youtube.com/embed/VIDEO_ID โดยตรงโดยไม่มีไฟล์ HTML ที่แนบมา คุณตั้งค่า Referer ได้โดยเพิ่มเป็นส่วนหัว HTTP ดังนี้

  • Android loadUrl ที่มีส่วนหัว HTTP ของ Referer เพิ่มลงในพารามิเตอร์ additionalHttpHeaders

  • iOS loadRequest: ที่มีส่วนหัว HTTP Referer เพิ่มลงในคำขอ เช่น

    NSString *bundleId = [[NSBundle mainBundle] bundleIdentifier];
    NSString *referrer = [[NSString stringWithFormat:@"https://%@", bundleId] lowercaseString];
    NSURL *referrerUrl = [NSURL URLWithString:referrer];
    
    NSString *destination = @"https://www.youtube.com/embed/VIDEO_ID";
    NSURL *destinationUrl = [NSURL URLWithString:destination];
    
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:destinationUrl];
    [request addValue:referrerUrl forHTTPHeaderField:@"Referer"];
    
    // Create an instance of WKWebView (omitted for simplicity), then load the NSMutableURLRequest.
    [webView loadRequest:request];
    

• แอปบนอุปกรณ์เคลื่อนที่มีเพลเยอร์อยู่ภายในแท็บเบราว์เซอร์ดั้งเดิม

  • Android CustomTabs

    ใช้ Intent.EXTRA_REFERRER เพื่อตั้งค่าผู้เข้าชมที่มา โปรดใช้รูปแบบ android-app:// แทน https:// เมื่อสร้าง Uri เช่น

    String destinationUrl = "https://www.youtube.com/embed/VIDEO_ID";
    CustomTabsIntent customTabsIntent = new CustomTabsIntent.Builder().build()
    customTabsIntent.intent.putExtra(Intent.EXTRA_REFERRER, Uri.parse("android-app://" + context.getPackageName()));
    customTabsIntent.launchUrl(this, Uri.parse(destinationUrl));
    

  • iOS SFSafariViewController

    SFSafariViewController ไม่รองรับการตั้งค่า Referer ในกรณีนี้ ให้ตั้งค่าพารามิเตอร์ของเพลเยอร์ origin แทน

• แอปเดสก์ท็อป

  ในการกำหนดค่านี้ ให้ตั้งค่า Referer โดยเพิ่มเป็นส่วนหัว HTTP ดังนี้

  • Microsoft .NET - ใช้ HttpRequestHeaders.Referrer หรือ CoreWebView2HttpRequestHeaders.SetHeader
  • macOS - ทำตามวิธีการเดียวกันกับที่อธิบายไว้ข้างต้นสำหรับแอปบนอุปกรณ์เคลื่อนที่ iOS

สำหรับแพลตฟอร์มอื่นๆ ที่ HTTP Referer ว่างเปล่าโดยค่าเริ่มต้น ให้ตั้งค่า Referer โดยกำหนดค่า WebView ที่โหลดเพลเยอร์ เทคนิคที่แน่นอนอาจแตกต่างกันไปตามแพลตฟอร์ม

หากคุณเป็นเจ้าของไลบรารี เฟรมเวิร์ก ปลั๊กอิน บริการ หรือ Wrapper ที่นักพัฒนาแอปใช้เพื่อผสานรวมเพลเยอร์ YouTube แบบฝัง คุณต้องดึงรหัสแอปจากสภาพแวดล้อม (อาจทำไม่ได้ ขึ้นอยู่กับแพลตฟอร์ม) หรืออนุญาตให้นักพัฒนาแอปส่งรหัสแอปของตนเพื่อให้ตั้งค่า Referer (และพารามิเตอร์เพลเยอร์ widget_referrer หากเหมาะสม) ได้ตามที่อธิบายไว้ข้างต้น

รูปแบบ Referer

เมื่อคุณระบุ Referer อย่างชัดเจนโดยการตั้งค่าพารามิเตอร์ WebView หรือเพิ่มส่วนหัว HTTP โดยทั่วไปรูปแบบจะเป็น URL ที่มีคุณสมบัติครบถ้วน ระบุ HTTPS เป็นโปรโตคอล ภายใน URL ชื่อโดเมนต้องเป็นตัวระบุแอปพลิเคชัน ("รหัสแอป") ที่ลงทะเบียนกับร้านค้าที่จัดจำหน่ายแอปของคุณให้แก่ผู้ใช้ปลายทาง หากแอปของคุณให้บริการแก่ผู้ใช้ผ่านช่องทางการจัดจำหน่ายอื่น ให้ใช้รหัสแอปที่ลงทะเบียนกับระบบปฏิบัติการในระหว่างการติดตั้งแอป ในกรณีส่วนใหญ่ รหัสแอปจะเป็นชื่อโดเมนที่กลับด้าน (หรือที่เรียกว่า "รูปแบบ DNS แบบย้อนกลับ") เช่น com.google.android.youtube ตัวอย่างที่แสดงให้เห็นถึงปัญหา

• ระบบปฏิบัติการ Android และแอป Android ใน ChromeOS: รหัสแอป
• แพลตฟอร์มของ Apple ซึ่งรวมถึง iOS, iPadOS, macOS: Bundle ID
• Samsung Tizen: รหัสแอป
• การกระจาย Linux:
  • Fedora: รหัสแอป
  • Gnome: รหัสแอป
  • Ubuntu: รหัสแอป

ในบางแพลตฟอร์ม รหัสแอปไม่ใช่ชื่อโดเมนที่กลับด้าน ในกรณีเหล่านี้ ให้ใช้รหัสแอปที่ไม่ซ้ำกันซึ่งกำหนดโดยร้านค้าที่จัดจำหน่ายแอป เมื่อรหัสแอปของร้านค้าเป็นสตริงตัวอักษรและตัวเลขที่สร้างขึ้น (กำหนดโดยร้านค้าหรือเครื่องมือพัฒนา ไม่ใช่สิ่งที่นักพัฒนาแอปเลือก) ให้ระบุทั้งชื่อที่แสดงของแอป (แทนที่ช่องว่างด้วยขีดกลาง) และรหัสแอปของร้านค้า โดยคั่นด้วยจุด ตัวอย่างเช่น <my-app-name>.<AppID> ค่านี้ควรมีความเสถียรเมื่อมีการเปลี่ยนแปลงเวอร์ชันของแอป หากไม่ได้โฮสต์แอปใน Store ให้ใช้รหัสแอปที่ลงทะเบียนกับระบบปฏิบัติการระหว่างการติดตั้งแอป ซึ่งโดยปกติแล้วจะเป็นตัวระบุที่ไม่ซ้ำกันในไฟล์ Manifest ของแอป ไม่รวมรายละเอียดเกี่ยวกับเวอร์ชันแอปและสถาปัตยกรรมที่รองรับ ตัวอย่างที่แสดงให้เห็นถึงปัญหา

• Chrome เว็บสโตร์: โฮสต์ในร้านค้า

  โดยปกติแล้ว รหัสแอปใน Store จะเป็นส่วนสุดท้ายของเส้นทางใน URL ของแอป https://chromewebstore.google.com/detail/<hyphenated-app-name>/<AppID> ใช้ชื่อแอปที่มีขีดกลางและรหัสแอปใน Store เพื่อสร้างสตริง <my-app-name>.<AppID> ตามที่อธิบายไว้ข้างต้น

• Windows: โฮสต์ใน Store

  โดยปกติแล้ว รหัสแอปใน Store จะเป็นส่วนสุดท้ายของเส้นทางใน URL ของแอป https://apps.microsoft.com/detail/<AppID> ใช้รหัสแอปใน Store เพื่อสร้างสตริง <my-app-name>.<AppID> ตามที่อธิบายไว้ข้างต้น และต้องระบุชื่อแอปที่มีขีดกลางด้วย

• Windows: การเผยแพร่นอก Store

  แอป Windows มีข้อมูลระบุแพ็กเกจในไฟล์ Manifest ของแอป: Name_Version_Architecture_ResourceID_PublisherID ใช้เฉพาะแอตทริบิวต์ Name

• Xbox: store-hosted

  โดยปกติแล้ว รหัสแอปใน Store จะเป็นส่วนสุดท้ายของเส้นทางใน URL ของแอป https://www.xbox.com/<region>/games/store/<hyphenated-app-name>/<AppID> ใช้ชื่อแอปที่มีขีดกลางและรหัสแอปใน Store เพื่อสร้างสตริง <my-app-name>.<AppID> ตามที่อธิบายไว้ข้างต้น

ไคลเอ็นต์ API ที่มีคำขอจำนวนมากไปยัง YouTube (ดูการใช้งานและโควต้า) อาจต้องใช้ข้อมูลเข้าสู่ระบบเพิ่มเติมเพื่อเข้าถึงโปรแกรมเล่นแบบฝังของ YouTube

การไม่ปฏิบัติตามข้อกำหนดเหล่านี้อาจส่งผลให้ฟังก์ชันการทำงานในโปรแกรมเล่น YouTube แบบฝังลดลง

ประเภท WebView

เมื่อผสานรวมโปรแกรมเล่นแบบฝังของ YouTube ใน WebView ให้ใช้ WebView ประเภทใดประเภทหนึ่งที่ระบบปฏิบัติการมีให้เมื่อพร้อมใช้งาน เช่น

• ระบบปฏิบัติการ Android: WebView หรือ CustomTabs
• แพลตฟอร์มของ Apple ซึ่งรวมถึง iOS, iPadOS, macOS: WKWebView หรือ SFSafariViewController

ขนาดโปรแกรมเล่น YouTube แบบฝัง

เพลเยอร์ที่ฝังต้องมีวิวพอร์ตขนาดอย่างน้อย 200 x 200 พิกเซล หากวิดีโอเพลเยอร์แสดงตัวควบคุม วิดีโอเพลเยอร์ต้องมีขนาดใหญ่พอที่จะแสดงตัวควบคุมทั้งหมดโดยไม่ย่อวิวพอร์ตให้ต่ำกว่าขนาดขั้นต่ำ เราขอแนะนำให้ใช้เพลเยอร์ 16:9 ที่มีความกว้างอย่างน้อย 480 พิกเซลและความสูง 270 พิกเซล

การเล่นอัตโนมัติและการเล่นตามสคริปต์

ส่วนนี้ครอบคลุมการเล่นอัตโนมัติ โดยมีผลบังคับใช้กับโปรแกรมเล่นแบบฝังของ YouTube ที่ใช้พารามิเตอร์เพลเยอร์ autoplay หรือเริ่มการเล่นอัตโนมัติแบบเป็นโปรแกรมโดยใช้บริการ YouTube IFrame Player API หรือบริการ YouTube API อื่น

• เพลเยอร์ที่ฝังซึ่งเล่นวิดีโอโดยอัตโนมัติควรเริ่มเล่นทันทีเมื่อหน้าเว็บโหลดหรือทันทีที่เพลเยอร์ที่ฝังปรากฏอย่างสมบูรณ์ อย่างไรก็ตาม ไคลเอ็นต์ API ต้องไม่เริ่มการเล่นอัตโนมัติจนกว่าเพลเยอร์จะปรากฏและเพลเยอร์มากกว่าครึ่งหนึ่งจะปรากฏในหน้าเว็บหรือหน้าจอ

• หน้าเว็บหรือหน้าจอต้องมีเพลเยอร์ YouTube ไม่เกิน 1 รายการที่เล่นเนื้อหาพร้อมกันโดยอัตโนมัติ

• ภาพปก YouTube ที่เริ่มการเล่นต้องมีความกว้างอย่างน้อย 120 พิกเซลและสูง 70 พิกเซล

แอตทริบิวต์ของ YouTube Player

แอตทริบิวต์และพารามิเตอร์ของโปรแกรมเล่น YouTube ซึ่งรวมถึงลักษณะที่ปรากฏของการสร้างแบรนด์ YouTube ในโปรแกรมเล่น เป็นต้น จะระบุไว้ในเอกสารประกอบและข้อกำหนดของ YouTube API (https://developers.google.com/youtube) คุณต้องไม่ทำการเปลี่ยนแปลงใดๆ กับเพลเยอร์ YouTube ที่ไม่ได้อธิบายไว้อย่างชัดเจนในเอกสารประกอบ API

การวางซ้อนและเฟรม

คุณต้องไม่แสดงภาพซ้อนทับ เฟรม หรือองค์ประกอบภาพอื่นๆ ที่อยู่ด้านหน้าส่วนใดส่วนหนึ่งของโปรแกรมเล่นวิดีโอ YouTube แบบฝัง รวมถึงตัวควบคุมโปรแกรมเล่น ในทำนองเดียวกัน คุณต้องไม่ใช้ภาพซ้อนทับ เฟรม หรือองค์ประกอบภาพอื่นๆ เพื่อบดบังส่วนใดส่วนหนึ่งของเพลเยอร์ที่ฝัง รวมถึงตัวควบคุมเพลเยอร์

เมาส์โอเวอร์

คุณต้องไม่ใช้การวางเมาส์หรือเหตุการณ์สัมผัสในเพลเยอร์ YouTube เพื่อเริ่มการดำเนินการในนามของผู้ใช้ เช่น การเปิดหน้าต่างหรือการติดตามช่อง

การอัปโหลดวิดีโอ

หากไคลเอ็นต์ API อนุญาตให้ผู้ใช้อัปโหลดเนื้อหาไปยังหลายแพลตฟอร์ม ผู้ใช้ควรเลือกและยกเลิกการเลือกแพลตฟอร์มที่ต้องการอัปโหลดวิดีโอได้

ข้อกำหนดด้านข้อมูล

ไคลเอ็นต์ API ที่อนุญาตให้ผู้ใช้อัปโหลดวิดีโอไปยัง YouTube ต้องอนุญาตให้ผู้ใช้ตั้งค่าในรายการต่อไปนี้ พร็อพเพอร์ตี้ที่ไม่ได้ระบุไว้เป็นพร็อพเพอร์ตี้ที่ไม่บังคับ

	ชื่อ	คำอธิบาย
พร็อพเพอร์ตี้ของทรัพยากร
	snippet.title	ต้องระบุ ชื่อวิดีโอ YouTube จะแสดงข้อผิดพลาดหากค่าเกิน 100 อักขระ YouTube รองรับอักขระ UTF-8 ที่ถูกต้องทั้งหมด ยกเว้น < และ >
	snippet.description	ต้องระบุ คำอธิบายของวิดีโอ YouTube จะแสดงข้อผิดพลาดหากค่าเกิน 5,000 ไบต์ YouTube รองรับอักขระ UTF-8 ที่ถูกต้องทั้งหมด ยกเว้น < และ >
	status.privacyStatus	ต้องระบุ การตั้งค่าความเป็นส่วนตัวของวิดีโอ ผู้ใช้ต้องเลือกได้ว่าจะให้วิดีโอที่อัปโหลดเป็นแบบสาธารณะ ส่วนตัว หรือไม่เป็นสาธารณะ
พารามิเตอร์คำขอ
	onBehalfOfContentOwnerChannel	ต้องระบุแบบมีเงื่อนไข หากข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอระบุเจ้าของเนื้อหาและมีการตั้งค่าพารามิเตอร์ onBehalfOfContentOwner ผู้ใช้ API จะต้องระบุช่อง YouTube ที่จะอัปโหลดวิดีโอได้ด้วย

การแสดงความคิดเห็น

	ชื่อ	คำอธิบาย
พร็อพเพอร์ตี้ของทรัพยากร
	snippet.textDisplay	ต้องระบุ ข้อความของความคิดเห็น ไคลเอ็นต์ API ต้อง (ก) แสดงข้อความแบบเต็มของความคิดเห็นหรือการตอบกลับความคิดเห็น หรือ (ข) ตัดข้อความและให้วิธีที่ผู้ชมเข้าถึงข้อความแบบเต็มจากเวอร์ชันที่ตัดได้ง่าย ข้อกำหนดนี้มีผลกับความคิดเห็นและการตอบกลับความคิดเห็นทั้งหมด ไม่ว่าความคิดเห็นจะเชื่อมโยงกับทรัพยากรประเภทใด (วิดีโอ ช่อง ฯลฯ) โปรดทราบว่าค่าพร็อพเพอร์ตี้ snippet.topLevelComment ของทรัพยากร commentThread คือทรัพยากร comment และพร็อพเพอร์ตี้ replies.comments[] คือรายการทรัพยากร comment ดังนั้น ข้อกำหนดนี้จึงมีผลกับพร็อพเพอร์ตี้ snippet.topLevelComment.snippet.textDisplay และ replies.comments[].snippet.textDisplay ด้วย
	snippet.title (channel)	ต้องระบุ (คำแนะนำ) ชื่อของช่อง หากความคิดเห็นเกี่ยวข้องกับช่อง ไคลเอ็นต์ API ต้องแสดงชื่อของช่อง หากความคิดเห็นเกี่ยวข้องกับวิดีโอ ไคลเอ็นต์ API ต้องแสดงชื่อช่องที่อัปโหลดวิดีโอ
	snippet.title (video)	ต้องระบุแบบมีเงื่อนไข (คำแนะนำ) ชื่อวิดีโอ ต้องแสดงค่านี้หากความคิดเห็นเกี่ยวข้องกับวิดีโอ
	snippet.moderationStatus	ต้องระบุแบบมีเงื่อนไข หากค่าพารามิเตอร์ moderationStatus ในคำขอ API เป็น heldForReview หรือ likelySpam การแสดงผลต้องระบุสถานะดังกล่าวอย่างชัดเจนโดยใช้ค่าพร็อพเพอร์ตี้ ภาษาที่คล้ายกัน (เช่น "ระบบกำลังเก็บความคิดเห็นนี้ไว้เพื่อตรวจสอบ") ส่วนหัว (เช่น "เก็บไว้เพื่อตรวจสอบ") หรือภาษาอื่นๆ ที่ไม่คลุมเครือ commentThreads.list เมธอดรองรับความสามารถในการดึงความคิดเห็นตามสถานะการดูแล

การแสดงความคิดเห็น

	ชื่อ	คำอธิบาย
พร็อพเพอร์ตี้ของทรัพยากร
	snippet.title (channel)	ต้องระบุ ชื่อของช่อง หากผู้ใช้เพิ่มความคิดเห็นเกี่ยวกับช่อง ไคลเอ็นต์ API ต้องแสดงชื่อของช่อง หากผู้ใช้แสดงความคิดเห็นเกี่ยวกับวิดีโอ ไคลเอ็นต์ API ต้องแสดงชื่อช่องที่อัปโหลดวิดีโอ
	snippet.title (video)	ต้องระบุ หากผู้ใช้แสดงความคิดเห็นเกี่ยวกับวิดีโอ ไคลเอ็นต์ API ต้องแสดงชื่อของวิดีโอ
ข้อกำหนดอื่นๆ
	Comment author's channel name	ต้องระบุ ไคลเอ็นต์ API ต้องระบุบัญชีผู้ใช้ YouTube ที่จะให้เครดิตความคิดเห็นอย่างชัดเจน หากข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอระบุเจ้าของเนื้อหาและมีการตั้งค่าพารามิเตอร์ onBehalfOfContentOwner ผู้ใช้ API จะต้องระบุช่อง YouTube ที่จะแสดงความคิดเห็นได้ด้วย

การเพิ่มการตอบกลับความคิดเห็น

	ชื่อ	คำอธิบาย
พร็อพเพอร์ตี้ของทรัพยากร
	snippet.textDisplay	ต้องระบุ ข้อความของความคิดเห็น ไคลเอ็นต์ API ต้องแสดงข้อความของความคิดเห็นที่ผู้ใช้ตอบกลับตามกฎที่กำหนดไว้ในส่วนการแสดงความคิดเห็นของเอกสารนี้
	snippet.title (channel)	ต้องระบุ ชื่อของช่อง หากผู้ใช้ตอบกลับความคิดเห็นเกี่ยวกับช่อง ไคลเอ็นต์ API ต้องแสดงชื่อของช่อง หากผู้ใช้ตอบกลับความคิดเห็นเกี่ยวกับวิดีโอ ไคลเอ็นต์ API ต้องแสดงชื่อของช่องที่อัปโหลดวิดีโอ
	snippet.title (video)	ต้องระบุ หากผู้ใช้ตอบกลับความคิดเห็นเกี่ยวกับวิดีโอ ไคลเอ็นต์ API ต้องแสดงชื่อวิดีโอ
ข้อกำหนดอื่นๆ
	Comment author's channel name	ต้องระบุ ไคลเอ็นต์ API ต้องระบุบัญชีผู้ใช้ YouTube ที่จะให้เครดิตการตอบกลับความคิดเห็นอย่างชัดเจน หากข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอระบุเจ้าของเนื้อหาและมีการตั้งค่าพารามิเตอร์ onBehalfOfContentOwner ผู้ใช้ API จะต้องระบุช่อง YouTube ที่จะให้เครดิตการตอบกลับความคิดเห็นได้ด้วย

การแก้ไขหรือลบการตอบกลับความคิดเห็น

	ชื่อ	คำอธิบาย
พร็อพเพอร์ตี้ของทรัพยากร
	snippet.textDisplay	ต้องระบุ ข้อความของความคิดเห็น ไคลเอ็นต์ API ต้องแสดงข้อความของความคิดเห็นที่ผู้ใช้กำลังแก้ไขหรือลบตามกฎที่กำหนดไว้ในส่วนการแสดงความคิดเห็นของเอกสารนี้
	snippet.title (channel)	ต้องระบุ ชื่อของช่อง หากผู้ใช้แก้ไขหรือลบความคิดเห็นเกี่ยวกับช่อง ไคลเอ็นต์ API ต้องแสดงชื่อของช่อง หากผู้ใช้แก้ไขหรือลบความคิดเห็นเกี่ยวกับวิดีโอ ไคลเอ็นต์ API ต้องแสดงชื่อของช่องที่อัปโหลดวิดีโอ
	snippet.title (video)	ต้องระบุ หากผู้ใช้แก้ไขหรือลบความคิดเห็นเกี่ยวกับวิดีโอ ไคลเอ็นต์ API ต้องแสดงชื่อวิดีโอ
ข้อกำหนดอื่นๆ
	Comment author's channel name	ต้องระบุ ไคลเอ็นต์ API ต้องระบุบัญชีผู้ใช้ YouTube ที่แสดงความคิดเห็นอย่างชัดเจน

การแบนผู้ใช้จากแชทสด (หรือยกเลิกการแบน)

	ชื่อ	คำอธิบาย
พร็อพเพอร์ตี้ของทรัพยากร
	snippet.title (channel)	ต้องระบุ ชื่อช่อง YouTube ที่ถูกแบนหรือเลิกแบน นอกจากนี้ ชื่อต้องลิงก์ไปยังช่องหรือต้องแสดง URL ของช่องด้วย
ข้อกำหนดอื่นๆ
	ชื่อช่องของผู้เขียนความคิดเห็น	ต้องระบุ ไคลเอ็นต์ API ต้องระบุบัญชีผู้ใช้ YouTube ที่ใช้เพิ่มหรือนำการแบนออกอย่างชัดเจน