Onayları yönetme

Bu belgede, Google Drive API'sinde onayların nasıl yönetileceği açıklanmaktadır.

İçerik onaylarınızı Google Drive'da bulabilirsiniz. Google Drive API, onaylarınızın durumunu alıp listeleyebilmeniz için approvals kaynağını sağlar. approvals kaynağının yöntemleri, Drive, Google Dokümanlar ve diğer Google Workspace düzenleyicilerindeki öğelerde çalışır.

Bu süreçten, sözleşme incelemesi veya yayınlanmadan önce resmi bir belge gibi resmi inceleme durumlarında onayları bulmak için yararlanabilirsiniz. Onay, hem incelemenin (ör. Devam Ediyor, Onaylandı veya Reddedildi) hem de ilgili incelemecilerin durumunu takip eder. Onaylar, içerikleri doğrulamak ve incelemecilerin kaydını tutmak için mükemmel bir yöntemdir.

Bir dosyayla ilgili onayları görüntülemek için dosyanın meta verilerini okuma izniniz olmalıdır. Daha fazla bilgi için Roller ve izinler başlıklı makaleyi inceleyin.

Alanlar parametresini kullanma

Yanıtla döndürülecek alanları belirtmek istiyorsanız fields system parametresini approvals kaynağının herhangi bir yöntemiyle ayarlayabilirsiniz. fields parametresini atlarsanız sunucu, yönteme özgü varsayılan bir alan kümesi döndürür. Farklı alanlar döndürmek için Belirli alanları döndürme başlıklı makaleye bakın.

Onay alma

Bir dosyanın onaylanması için fileId ve approvalId yol parametreleriyle approvals kaynağında get yöntemini kullanın. Onay kimliğini bilmiyorsanız list yöntemini kullanarak onayları listeleyebilirsiniz.

Yanıt gövdesi, approvals kaynağının bir örneğini içerir.

Onayları listeleme

Bir dosyadaki onayları listelemek için approvals kaynağında list yöntemini çağırın ve fileId yol parametresini ekleyin.

Yanıt gövdesi, dosyadaki onayların listesinden oluşur. items alanı, formdaki her onay hakkında approvals kaynağı biçiminde bilgiler içerir.

approvals kaynağı, onayın durumunu ayrıntılandıran bir Status nesnesinin yanı sıra belirli bir incelemeci tarafından yapılan onaya verilen yanıtı ayrıntılandıran ReviewerResponse nesnesini de içerir. Bu yorumcunun yanıtı Response nesnesiyle gösterilir.

Ayrıca, onayların sayfalara ayrılmasını özelleştirmek veya onayları filtrelemek için aşağıdaki sorgu parametrelerini de iletebilirsiniz:

  • pageSize: Sayfa başına döndürülecek maksimum onay sayısı. pageSize değerini ayarlamazsanız sunucu en fazla 100 onay döndürür.

  • pageToken: Önceki bir liste çağrısından alınan sayfa jetonu. Bu jeton, sonraki sayfayı almak için kullanılır. Önceki yanıttaki nextPageToken değerine ayarlanmalıdır.