การเชื่อมต่อ HTTP แต่ละครั้งที่แอปพลิเคชันของคุณทำให้เกิดโอเวอร์เฮดจำนวนหนึ่ง ไลบรารีนี้รองรับการทำงานแบบกลุ่มเพื่อให้แอปพลิเคชันของคุณใส่การเรียก API หลายรายการลงในคำขอ HTTP รายการเดียวได้ ตัวอย่างสถานการณ์ที่คุณอาจต้องใช้การทำงานแบบกลุ่มมีดังนี้
- คุณมีคำขอเล็กๆ จำนวนมากและต้องการลดค่าใช้จ่ายคำขอ HTTP ลง
- ผู้ใช้ทำการเปลี่ยนแปลงข้อมูลขณะที่แอปพลิเคชันออฟไลน์ ดังนั้นแอปพลิเคชันจึงต้องซิงค์ข้อมูลในเครื่องกับเซิร์ฟเวอร์โดยส่งการอัปเดตและลบจำนวนมาก
หมายเหตุ: คุณสามารถโทรได้ไม่เกิน 1,000 สายต่อคำขอเป็นกลุ่ม หากต้องการให้มีการเรียกมากกว่านั้น ให้ใช้คำขอแบบกลุ่มหลายรายการ
หมายเหตุ: คุณใช้ออบเจ็กต์การอัปโหลดสื่อในคำขอแบบกลุ่มไม่ได้
รายละเอียด
คุณสร้างคำขอแบบกลุ่มได้ด้วยการสร้างอินสแตนซ์ออบเจ็กต์ BatchRequest
แล้วเรียกเมธอด Queue
สำหรับแต่ละคำขอที่ต้องการดำเนินการ
สำหรับคำขอแต่ละรายการ ให้ส่งการเรียกกลับเพื่อเรียกเมื่อแอปพลิเคชันได้รับการตอบสนองคำขอนั้น
อาร์กิวเมนต์ของฟังก์ชันเรียกกลับมีดังนี้
- content
- การตอบกลับของเนื้อหาหรือ
null
หากคำขอล้มเหลว - error
- ข้อผิดพลาดหรือ
null
หากคำขอประสบความสำเร็จ - index
- ดัชนีของคำขอแต่ละรายการ
- ข้อความ
- ข้อความ HTTP แบบเต็มที่มีส่วนหัวและเนื้อหาทั้งหมด
ExecuteAsync
เพื่อสร้างคำขอ
ในข้อมูลโค้ดต่อไปนี้ คำขอ API 2 รายการจะจัดกลุ่มเป็นคำขอ HTTP รายการเดียว และคำขอ API แต่ละรายการจะได้รับการเรียกกลับ
UserCredential credential; using (var stream = new FileStream("client_secrets.json", FileMode.Open, FileAccess.Read)) { credential = await GoogleWebAuthorizationBroker.AuthorizeAsync( GoogleClientSecrets.Load(stream).Secrets, new[] { CalendarService.Scope.Calendar }, "user", CancellationToken.None, new FileDataStore("Calendar.Sample.Store")); } // Create the service. var service = new CalendarService(new BaseClientService.Initializer() { HttpClientInitializer = credential, ApplicationName = "Google Calendar API Sample", }); // Create a batch request. var request = new BatchRequest(service); request.Queue<CalendarList>(service.CalendarList.List(), (content, error, i, message) => { // Put your callback code here. }); request.Queue<Event>(service.Events.Insert( new Event { Summary = "Learn how to execute a batch request", Start = new EventDateTime() { DateTime = new DateTime(2014, 1, 1, 10, 0, 0) }, End = new EventDateTime() { DateTime = new DateTime(2014, 1, 1, 12, 0, 0) } }, "YOUR_CALENDAR_ID_HERE"), (content, error, i, message) => { // Put your callback code here. }); // You can add more Queue calls here. // Execute the batch request, which includes the 2 requests above. await request.ExecuteAsync();