MDL-61768 repository_googledocs: Deprecate unused methods

Deprecates methods from the repository_googledocs class which are
no longer used.

repository/googledocs/lib.php

@@ -176,10 +176,14 @@ public function print_login_popup($attr = null) {
     /**
      * Build the breadcrumb from a path.
      *
+     * @deprecated since Moodle 3.11.
      * @param string $path to create a breadcrumb from.
      * @return array containing name and path of each crumb.
      */
     protected function build_breadcrumb($path) {
+        debugging('The function build_breadcrumb() is deprecated, please use get_navigation() from the ' .
+            'googledocs repository content classes instead.', DEBUG_DEVELOPER);
+
         $bread = explode('/', $path);
         $crumbtrail = '';
         foreach ($bread as $crumb) {
@@ -200,12 +204,16 @@ protected function build_breadcrumb($path) {
      *
      * Typically, a node will be id|Name of the node.
      *
+     * @deprecated since Moodle 3.11.
      * @param string $id of the node.
      * @param string $name of the node, will be URL encoded.
      * @param string $root to append the node on, must be a result of this function.
      * @return string path to the node.
      */
     protected function build_node_path($id, $name = '', $root = '') {
+        debugging('The function build_node_path() is deprecated, please use ' .
+            '\repository_googledocs\helper::build_node_path() instead.', DEBUG_DEVELOPER);
+
         $path = $id;
         if (!empty($name)) {
             $path .= '|' . urlencode($name);
@@ -219,11 +227,15 @@ protected function build_node_path($id, $name = '', $root = '') {
     /**
      * Returns information about a node in a path.
      *
+     * @deprecated since Moodle 3.11.
      * @see self::build_node_path()
      * @param string $node to extrat information from.
      * @return array about the node.
      */
     protected function explode_node_path($node) {
+        debugging('The function explode_node_path() is deprecated, please use ' .
+            '\repository_googledocs\helper::explode_node_path() instead.', DEBUG_DEVELOPER);
+
         if (strpos($node, '|') !== false) {
             list($id, $name) = explode('|', $node, 2);
             $name = urldecode($name);
@@ -331,12 +343,16 @@ public function search($searchtext, $page = 0) {
      * This returns a list of files and folders with their details as they should be
      * formatted and returned by functions such as get_listing() or search().
      *
+     * @deprecated since Moodle 3.11.
      * @param string $q search query as expected by the Google API.
      * @param string $path parent path of the current files, will not be used for the query.
      * @param int $page page.
      * @return array of files and folders.
      */
     protected function query($q, $path = null, $page = 0) {
+        debugging('The function query() is deprecated, please use get_content_nodes() from the ' .
+            'googledocs repository content classes instead.', DEBUG_DEVELOPER);
+
         global $OUTPUT;
 
         $files = array();

repository/upgrade.txt

@@ -7,6 +7,14 @@ http://docs.moodle.org/dev/Repository_API
 * The Google Drive repository now includes a new rest API function 'shared_drives_list', which can be used to fetch
   a list of existing shared drives.
 * The Google Drive repository now supports browsing and searching for content from shared drives.
+* The method build_breadcrumb() in repository/googledocs/lib.php has been deprecated, please use get_navigation()
+  from the googledocs repository content classes instead.
+* The method build_node_path() in repository/googledocs/lib.php has been deprecated, please use
+  \repository_googledocs\helper::build_node_path() instead.
+* The method explode_node_path() in repository/googledocs/lib.php has been deprecated, please use
+  \repository_googledocs\helper::explode_node_path() instead.
+* The function query() in repository/googledocs/lib.php is deprecated, please use get_content_nodes() from the
+  googledocs repository content classes instead.
 
 === 3.4 ===
 Repositories should no longer directly call file_system#add_file_to_pool or file_system#add_string_to_pool