add parsePerms() method to obtain app permissions #6

Merge pull request #6 from IzzySoft/gperms

Author: BaseMax

README.md

@@ -141,6 +141,74 @@ Array
 )
 ```
 
+### Obtaining app permissions
+Using `$google->parsePerms($packageName)` you can obtain permissions for a given app. As with the structures returned for apps, the keys `success` and `message` are used to indicate the status. For data itself, you'll find a list by permission groups behind the `grouped` key – and "unified permissions" behind the `perms` key. Example output:
+
+```
+Array
+(
+    [success] => 1
+    [grouped] => Array
+        (
+            [storage] => Array
+                (
+                    [group_name] => Storage
+                    [perms] => Array
+                        (
+                            [0] => Array
+                                (
+                                    [0] => 
+                                    [1] => modify or delete the contents of your USB storage
+                                )
+                            [1] => Array
+                                (
+                                    [0] => 
+                                    [1] => read the contents of your USB storage
+                                )
+                        )
+                )
+            [perm_media] => Array
+                (
+                    [group_name] => Photos/Media/Files
+                    [perms] => Array
+                        (
+                            [0] => Array
+                                (
+                                    [0] => 
+                                    [1] => modify or delete the contents of your USB storage
+                                )
+                            [1] => Array
+                                (
+                                    [0] => 
+                                    [1] => read the contents of your USB storage
+                                )
+                        )
+                )
+            [perm_camera_mic] => Array
+                (
+                    [group_name] => Microphone
+                    [perms] => Array
+                        (
+                            [0] => Array
+                                (
+                                    [0] => 
+                                    [1] => record audio
+                                )
+                        )
+                )
+        )
+    [perms] => Array
+        (
+            [0] => modify or delete the contents of your USB storage
+            [1] => read the contents of your USB storage
+            [4] => record audio
+        )
+)
+```
+
+The `grouped` keys are the IDs given to the permission groups by Google. The empty `[0]` key for permissions in the `grouped` tree is as shipped by Google; no idea what it is reserved for until some values show up here.
+
+
 ### TODO
 
 - Unit test

google-play.php

@@ -166,6 +166,43 @@ public function parse($link=null) {
     return $values;
   }
 
+  public function parsePerms($packageName) {
+    $opts = ['http' => array(
+      'method'  => 'POST',
+      'header'  => 'Content-type: application/x-www-form-urlencoded;charset=utf-8'
+                  ."\r\n".'Referer: https://play.google.com/',
+      'content' => 'f.req=%5B%5B%5B%22xdSrCf%22%2C%22%5B%5Bnull%2C%5B%5C%22'.$packageName.'%5C%22%2C7%5D%2C%5B%5D%5D%5D%22%2Cnull%2C%221%22%5D%5D%5D',
+      'ignore_errors' => TRUE
+      )
+    ];
+    $context  = stream_context_create($opts);
+    if ( $proto = @file_get_contents('https://play.google.com/_/PlayStoreUi/data/batchexecute?rpcids=xdSrCf&bl=boq_playuiserver_20201201.06_p0&hl=en&authuser&soc-app=121&soc-platform=1&soc-device=1&rt=c&f.sid=-8792622157958052111&_reqid=257685', false, $context) ) { // raw proto_buf data
+      preg_match("!HTTP/1\.\d\s+(\d{3})\s+(.+)$!i",$http_response_header[0],$match);
+      $response_code = $match[1];
+      switch ($response_code) {
+        case "200" : // HTTP/1.0 200 OK
+          break;
+        case "400" : // echo "! No XHR for '$pkg'\n";
+        case "404" : // app no longer on play
+        default:
+          return ['success'=>0,'message'=>$http_response_header[0]];
+          break;
+      }
+    } else { // network error (e.g. "failed to open stream: Connection timed out")
+      return ['success'=>0,'message'=>'network error'];
+    }
+
+    $perms = $perms_unique = [];
+    $json = preg_replace('!.*?(\[.+?\])\s*\d.*!ims','$1',$proto);
+    $arr = json_decode($json)[0][2];
+    foreach (json_decode($arr)[0] as $group) { // 0: group name, 1: group icon, 2: perms, 3: group_id
+      $perms[$group[3][0]] = ['group_name'=>$group[0], 'perms'=>$group[2]];
+      foreach($group[2] as $perm) $perms_unique[] = $perm[1];
+    }
+
+    return ['success'=>1,'grouped'=>$perms,'perms'=>array_unique($perms_unique)];
+  }
+
   public function parseCategory($category) {
     $link="https://play.google.com/store/apps/category/".$category;
     return $this->parse($link);