* $driveService = new Google\Service\Drive(...); * $comments = $driveService->comments; * */ class Comments extends \Google\Service\Resource { /** * Creates a new comment on a file. (comments.create) * * @param string $fileId The ID of the file. * @param Comment $postBody * @param array $optParams Optional parameters. * @return Comment */ public function create($fileId, Comment $postBody, $optParams = []) { $params = ['fileId' => $fileId, 'postBody' => $postBody]; $params = array_merge($params, $optParams); return $this->call('create', [$params], Comment::class); } /** * Deletes a comment. (comments.delete) * * @param string $fileId The ID of the file. * @param string $commentId The ID of the comment. * @param array $optParams Optional parameters. */ public function delete($fileId, $commentId, $optParams = []) { $params = ['fileId' => $fileId, 'commentId' => $commentId]; $params = array_merge($params, $optParams); return $this->call('delete', [$params]); } /** * Gets a comment by ID. (comments.get) * * @param string $fileId The ID of the file. * @param string $commentId The ID of the comment. * @param array $optParams Optional parameters. * * @opt_param bool includeDeleted Whether to return deleted comments. Deleted * comments will not include their original content. * @return Comment */ public function get($fileId, $commentId, $optParams = []) { $params = ['fileId' => $fileId, 'commentId' => $commentId]; $params = array_merge($params, $optParams); return $this->call('get', [$params], Comment::class); } /** * Lists a file's comments. (comments.listComments) * * @param string $fileId The ID of the file. * @param array $optParams Optional parameters. * * @opt_param bool includeDeleted Whether to include deleted comments. Deleted * comments will not include their original content. * @opt_param int pageSize The maximum number of comments to return per page. * @opt_param string pageToken The token for continuing a previous list request * on the next page. This should be set to the value of 'nextPageToken' from the * previous response. * @opt_param string startModifiedTime The minimum value of 'modifiedTime' for * the result comments (RFC 3339 date-time). * @return CommentList */ public function listComments($fileId, $optParams = []) { $params = ['fileId' => $fileId]; $params = array_merge($params, $optParams); return $this->call('list', [$params], CommentList::class); } /** * Updates a comment with patch semantics. (comments.update) * * @param string $fileId The ID of the file. * @param string $commentId The ID of the comment. * @param Comment $postBody * @param array $optParams Optional parameters. * @return Comment */ public function update($fileId, $commentId, Comment $postBody, $optParams = []) { $params = ['fileId' => $fileId, 'commentId' => $commentId, 'postBody' => $postBody]; $params = array_merge($params, $optParams); return $this->call('update', [$params], Comment::class); } } // Adding a class alias for backwards compatibility with the previous class name. class_alias(Comments::class, 'Google_Service_Drive_Resource_Comments');