Office365-REST-Python-Client 2.5.10__tar.gz → 2.5.11__tar.gz

{Office365-REST-Python-Client-2.5.10 → office365_rest_python_client-2.5.11/Office365_REST_Python_Client.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: Office365-REST-Python-Client
-Version: 2.5.10
+Version: 2.5.11
 Summary: Microsoft 365 & Microsoft Graph Library for Python
 Home-page: https://github.com/vgrem/Office365-REST-Python-Client
 Author: Vadim Gremyachev
@@ -26,8 +26,13 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Description-Content-Type: text/markdown
-Provides-Extra: NtlmProvider
 License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: msal
+Requires-Dist: pytz
+Requires-Dist: typing_extensions>=4.0.0
+Provides-Extra: ntlmprovider
+Requires-Dist: requests_ntlm; extra == "ntlmprovider"
 
 # About
 Microsoft 365 & Microsoft Graph library for Python
@@ -140,7 +145,7 @@ Steps to access:
   Usage:
 ```python
 from office365.sharepoint.client_context import ClientContext
-ctx = ClientContext(site_url).with_interactive(tenant_name_or_id, client_id)
+ctx = ClientContext("{site-url}").with_interactive("{tenant-name-or-id}", "{client-id}")
 me = ctx.web.current_user.get().execute_query()
 print(me.login_name)
 ```
@@ -173,19 +178,17 @@ print("Web title: {0}".format(web.properties['Title']))
 ```
 
 
-2. `RequestOptions class` - where you construct REST queries (and no model is involved)
+2. `SharePointRequest class` - where you construct REST queries (and no model is involved)
 
    The example demonstrates how to read `Web` properties:
    
 ```python
 import json
 from office365.runtime.auth.user_credential import UserCredential
-from office365.runtime.http.request_options import RequestOptions
-from office365.sharepoint.client_context import ClientContext
+from office365.sharepoint.request import SharePointRequest
 site_url = "https://{your-tenant-prefix}.sharepoint.com"
-ctx = ClientContext(site_url).with_credentials(UserCredential("{username}", "{password}"))
-request = RequestOptions("{0}/_api/web/".format(site_url))
-response = ctx.pending_request().execute_request_direct(request)
+request = SharePointRequest(site_url).with_credentials(UserCredential("{username}", "{password}"))
+response = request.execute_request("web")
 json = json.loads(response.content)
 web_title = json['d']['Title']
 print("Web title: {0}".format(web_title))
@@ -215,6 +218,7 @@ Refer [examples section](examples/sharepoint) for another scenarios
 
    Example:
    ```python
+   from office365.sharepoint.client_context import ClientContext
    client_credentials = ClientCredential('{client_id}','{client_secret}')
    ctx = ClientContext('{url}').with_credentials(client_credentials, environment='GCCH')
    ```
@@ -426,7 +430,7 @@ which corresponds to [`Create team` endpoint](https://docs.microsoft.com/en-us/g
 ```python
 from office365.graph_client import GraphClient
 client = GraphClient(acquire_token_func)
-new_team = client.groups["{group_id}"].add_team().execute_query_retry()
+new_team = client.groups["{group-id}"].add_team().execute_query_retry()
 ```
 
 Additional examples:

{Office365-REST-Python-Client-2.5.10 → office365_rest_python_client-2.5.11}/Office365_REST_Python_Client.egg-info/SOURCES.txt

@@ -202,11 +202,14 @@ office365/directory/identitygovernance/appconsent/__init__.py
 office365/directory/identitygovernance/appconsent/approval_route.py
 office365/directory/identitygovernance/appconsent/request.py
 office365/directory/identitygovernance/appconsent/request_collection.py
+office365/directory/identitygovernance/appconsent/request_scope.py
 office365/directory/identitygovernance/entitlementmanagement/__init__.py
 office365/directory/identitygovernance/entitlementmanagement/entitlement_management.py
 office365/directory/identitygovernance/lifecycleworkflows/__init__.py
 office365/directory/identitygovernance/privilegedaccess/__init__.py
+office365/directory/identitygovernance/privilegedaccess/group.py
 office365/directory/identitygovernance/privilegedaccess/root.py
+office365/directory/identitygovernance/privilegedaccess/schedule_instance.py
 office365/directory/identitygovernance/termsofuse/__init__.py
 office365/directory/identitygovernance/termsofuse/agreement.py
 office365/directory/identitygovernance/termsofuse/agreement_acceptance.py
@@ -250,6 +253,7 @@ office365/directory/permissions/grants/condition_set.py
 office365/directory/permissions/grants/oauth2.py
 office365/directory/permissions/grants/resource_specific.py
 office365/directory/policies/__init__.py
+office365/directory/policies/admin_consent_request.py
 office365/directory/policies/app_management.py
 office365/directory/policies/authentication_flows.py
 office365/directory/policies/authentication_methods.py
@@ -337,6 +341,7 @@ office365/directory/synchronization/quarantine.py
 office365/directory/synchronization/schema.py
 office365/directory/synchronization/status.py
 office365/directory/synchronization/synchronization.py
+office365/directory/synchronization/task_execution.py
 office365/directory/synchronization/template.py
 office365/directory/users/__init__.py
 office365/directory/users/collection.py
@@ -547,6 +552,8 @@ office365/onedrive/sites/__init__.py
 office365/onedrive/sites/site.py
 office365/onedrive/sites/site_collection.py
 office365/onedrive/sites/sites_with_root.py
+office365/onedrive/storage/__init__.py
+office365/onedrive/storage/storage.py
 office365/onedrive/termstore/__init__.py
 office365/onedrive/termstore/relation.py
 office365/onedrive/termstore/store.py
@@ -960,6 +967,7 @@ office365/sharepoint/campaigns/communication_entity.py
 office365/sharepoint/campaigns/entity.py
 office365/sharepoint/changes/__init__.py
 office365/sharepoint/changes/alert.py
+office365/sharepoint/changes/app_consent_principal.py
 office365/sharepoint/changes/change.py
 office365/sharepoint/changes/collection.py
 office365/sharepoint/changes/content_type.py
@@ -1522,6 +1530,7 @@ office365/sharepoint/sharing/permission_information.py
 office365/sharepoint/sharing/personal_web.py
 office365/sharepoint/sharing/picker_settings.py
 office365/sharepoint/sharing/principal.py
+office365/sharepoint/sharing/recipient_limits.py
 office365/sharepoint/sharing/result.py
 office365/sharepoint/sharing/role.py
 office365/sharepoint/sharing/role_type.py

{Office365-REST-Python-Client-2.5.10/Office365_REST_Python_Client.egg-info → office365_rest_python_client-2.5.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: Office365-REST-Python-Client
-Version: 2.5.10
+Version: 2.5.11
 Summary: Microsoft 365 & Microsoft Graph Library for Python
 Home-page: https://github.com/vgrem/Office365-REST-Python-Client
 Author: Vadim Gremyachev
@@ -26,8 +26,13 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Description-Content-Type: text/markdown
-Provides-Extra: NtlmProvider
 License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: msal
+Requires-Dist: pytz
+Requires-Dist: typing_extensions>=4.0.0
+Provides-Extra: ntlmprovider
+Requires-Dist: requests_ntlm; extra == "ntlmprovider"
 
 # About
 Microsoft 365 & Microsoft Graph library for Python
@@ -140,7 +145,7 @@ Steps to access:
   Usage:
 ```python
 from office365.sharepoint.client_context import ClientContext
-ctx = ClientContext(site_url).with_interactive(tenant_name_or_id, client_id)
+ctx = ClientContext("{site-url}").with_interactive("{tenant-name-or-id}", "{client-id}")
 me = ctx.web.current_user.get().execute_query()
 print(me.login_name)
 ```
@@ -173,19 +178,17 @@ print("Web title: {0}".format(web.properties['Title']))
 ```
 
 
-2. `RequestOptions class` - where you construct REST queries (and no model is involved)
+2. `SharePointRequest class` - where you construct REST queries (and no model is involved)
 
    The example demonstrates how to read `Web` properties:
    
 ```python
 import json
 from office365.runtime.auth.user_credential import UserCredential
-from office365.runtime.http.request_options import RequestOptions
-from office365.sharepoint.client_context import ClientContext
+from office365.sharepoint.request import SharePointRequest
 site_url = "https://{your-tenant-prefix}.sharepoint.com"
-ctx = ClientContext(site_url).with_credentials(UserCredential("{username}", "{password}"))
-request = RequestOptions("{0}/_api/web/".format(site_url))
-response = ctx.pending_request().execute_request_direct(request)
+request = SharePointRequest(site_url).with_credentials(UserCredential("{username}", "{password}"))
+response = request.execute_request("web")
 json = json.loads(response.content)
 web_title = json['d']['Title']
 print("Web title: {0}".format(web_title))
@@ -215,6 +218,7 @@ Refer [examples section](examples/sharepoint) for another scenarios
 
    Example:
    ```python
+   from office365.sharepoint.client_context import ClientContext
    client_credentials = ClientCredential('{client_id}','{client_secret}')
    ctx = ClientContext('{url}').with_credentials(client_credentials, environment='GCCH')
    ```
@@ -426,7 +430,7 @@ which corresponds to [`Create team` endpoint](https://docs.microsoft.com/en-us/g
 ```python
 from office365.graph_client import GraphClient
 client = GraphClient(acquire_token_func)
-new_team = client.groups["{group_id}"].add_team().execute_query_retry()
+new_team = client.groups["{group-id}"].add_team().execute_query_retry()
 ```
 
 Additional examples:

{Office365-REST-Python-Client-2.5.10 → office365_rest_python_client-2.5.11}/README.md

@@ -109,7 +109,7 @@ Steps to access:
   Usage:
 ```python
 from office365.sharepoint.client_context import ClientContext
-ctx = ClientContext(site_url).with_interactive(tenant_name_or_id, client_id)
+ctx = ClientContext("{site-url}").with_interactive("{tenant-name-or-id}", "{client-id}")
 me = ctx.web.current_user.get().execute_query()
 print(me.login_name)
 ```
@@ -142,19 +142,17 @@ print("Web title: {0}".format(web.properties['Title']))
 ```
 
 
-2. `RequestOptions class` - where you construct REST queries (and no model is involved)
+2. `SharePointRequest class` - where you construct REST queries (and no model is involved)
 
    The example demonstrates how to read `Web` properties:
    
 ```python
 import json
 from office365.runtime.auth.user_credential import UserCredential
-from office365.runtime.http.request_options import RequestOptions
-from office365.sharepoint.client_context import ClientContext
+from office365.sharepoint.request import SharePointRequest
 site_url = "https://{your-tenant-prefix}.sharepoint.com"
-ctx = ClientContext(site_url).with_credentials(UserCredential("{username}", "{password}"))
-request = RequestOptions("{0}/_api/web/".format(site_url))
-response = ctx.pending_request().execute_request_direct(request)
+request = SharePointRequest(site_url).with_credentials(UserCredential("{username}", "{password}"))
+response = request.execute_request("web")
 json = json.loads(response.content)
 web_title = json['d']['Title']
 print("Web title: {0}".format(web_title))
@@ -184,6 +182,7 @@ Refer [examples section](examples/sharepoint) for another scenarios
 
    Example:
    ```python
+   from office365.sharepoint.client_context import ClientContext
    client_credentials = ClientCredential('{client_id}','{client_secret}')
    ctx = ClientContext('{url}').with_credentials(client_credentials, environment='GCCH')
    ```
@@ -395,7 +394,7 @@ which corresponds to [`Create team` endpoint](https://docs.microsoft.com/en-us/g
 ```python
 from office365.graph_client import GraphClient
 client = GraphClient(acquire_token_func)
-new_team = client.groups["{group_id}"].add_team().execute_query_retry()
+new_team = client.groups["{group-id}"].add_team().execute_query_retry()
 ```
 
 Additional examples:

office365_rest_python_client-2.5.11/office365/directory/identitygovernance/appconsent/request.py

@@ -0,0 +1,58 @@
+from typing import Optional
+
+from office365.directory.identitygovernance.appconsent.request_scope import (
+    AppConsentRequestScope,
+)
+from office365.directory.identitygovernance.userconsent.request_collection import (
+    UserConsentRequestCollection,
+)
+from office365.entity import Entity
+from office365.runtime.client_value_collection import ClientValueCollection
+from office365.runtime.paths.resource_path import ResourcePath
+
+
+class AppConsentRequest(Entity):
+    """
+    Represents the request that a user creates when they request the tenant admin for consent to access an app or
+    to grant permissions to an app. The details include the app that the user wants access to be granted to on their
+    behalf and the permissions that the user is requesting.
+
+    The user can create a consent request when an app or a permission requires admin authorization and only when
+    the admin consent workflow is enabled.
+    """
+
+    def __str__(self):
+        return self.app_display_name or self.entity_type_name
+
+    def __repr__(self):
+        return self.app_id or self.entity_type_name
+
+    @property
+    def app_display_name(self):
+        # type: () -> Optional[str]
+        """Display name of the application object on which this extension property is defined. Read-only"""
+        return self.properties.get("appDisplayName", None)
+
+    @property
+    def app_id(self):
+        # type: () -> Optional[str]
+        """The identifier of the application"""
+        return self.properties.get("appId", None)
+
+    @property
+    def pending_scopes(self):
+        # type: () -> ClientValueCollection[AppConsentRequestScope]
+        """A list of pending scopes waiting for approval. Required."""
+        return self.properties.get(
+            "pendingScopes", ClientValueCollection(AppConsentRequestScope)
+        )
+
+    @property
+    def user_consent_requests(self):
+        """A list of pending user consent requests."""
+        return self.properties.get(
+            "userConsentRequests",
+            UserConsentRequestCollection(
+                self.context, ResourcePath("userConsentRequests", self.resource_path)
+            ),
+        )

office365_rest_python_client-2.5.11/office365/directory/identitygovernance/appconsent/request_scope.py

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class AppConsentRequestScope(ClientValue):
+    """The appConsentRequestScope details the dynamic permission scopes for which access is being requested."""

office365_rest_python_client-2.5.11/office365/directory/identitygovernance/privilegedaccess/group.py

@@ -0,0 +1,5 @@
+from office365.entity import Entity
+
+
+class PrivilegedAccessGroup(Entity):
+    """The entry point for all resources related to Privileged Identity Management (PIM) for groups."""

office365_rest_python_client-2.5.11/office365/directory/identitygovernance/privilegedaccess/root.py

@@ -0,0 +1,19 @@
+from office365.directory.identitygovernance.privilegedaccess.group import (
+    PrivilegedAccessGroup,
+)
+from office365.entity import Entity
+from office365.runtime.paths.resource_path import ResourcePath
+
+
+class PrivilegedAccessRoot(Entity):
+    """Represents the entry point for resources related to Privileged Identity Management (PIM)."""
+
+    @property
+    def group(self):
+        """A list of pending user consent requests."""
+        return self.properties.get(
+            "group",
+            PrivilegedAccessGroup(
+                self.context, ResourcePath("group", self.resource_path)
+            ),
+        )

office365_rest_python_client-2.5.11/office365/directory/identitygovernance/privilegedaccess/schedule_instance.py

@@ -0,0 +1,6 @@
+from office365.entity import Entity
+
+
+class PrivilegedAccessScheduleInstance(Entity):
+    """An abstract type that exposes properties relating to the instances of membership and ownership assignments
+    and eligibilities to groups that are governed by PIM"""

office365_rest_python_client-2.5.11/office365/directory/policies/admin_consent_request.py

@@ -0,0 +1,10 @@
+from office365.entity import Entity
+
+
+class AdminConsentRequestPolicy(Entity):
+    """
+    Represents the policy for enabling or disabling the Microsoft Entra admin consent workflow.
+    The admin consent workflow allows users to request access for apps that they wish to use and that require admin
+    authorization before users can use the apps to access organizational data.
+    There is a single adminConsentRequestPolicy per tenant.
+    """

{Office365-REST-Python-Client-2.5.10 → office365_rest_python_client-2.5.11}/office365/directory/policies/root.py

@@ -1,3 +1,4 @@
+from office365.directory.policies.admin_consent_request import AdminConsentRequestPolicy
 from office365.directory.policies.app_management import AppManagementPolicy
 from office365.directory.policies.authentication_flows import AuthenticationFlowsPolicy
 from office365.directory.policies.authentication_methods import (
@@ -20,6 +21,19 @@ from office365.runtime.paths.resource_path import ResourcePath
 class PolicyRoot(Entity):
     """Resource type exposing navigation properties for the policies singleton."""
 
+    @property
+    def admin_consent_request_policy(self):
+        """
+        The policy by which consent requests are created and managed for the entire tenant.
+        """
+        return self.properties.get(
+            "adminConsentRequestPolicy",
+            AdminConsentRequestPolicy(
+                self.context,
+                ResourcePath("adminConsentRequestPolicy", self.resource_path),
+            ),
+        )
+
     @property
     def authentication_methods_policy(self):
         """
@@ -151,6 +165,7 @@ class PolicyRoot(Entity):
     def get_property(self, name, default_value=None):
         if default_value is None:
             property_mapping = {
+                "adminConsentRequestPolicy": self.admin_consent_request_policy,
                 "authenticationStrengthPolicies": self.authentication_strength_policies,
                 "authenticationFlowsPolicy": self.authentication_flows_policy,
                 "appManagementPolicies": self.app_management_policies,

{Office365-REST-Python-Client-2.5.10 → office365_rest_python_client-2.5.11}/office365/directory/synchronization/status.py

@@ -1,5 +1,8 @@
 from office365.directory.synchronization.progress import SynchronizationProgress
 from office365.directory.synchronization.quarantine import SynchronizationQuarantine
+from office365.directory.synchronization.task_execution import (
+    SynchronizationTaskExecution,
+)
 from office365.runtime.client_value import ClientValue
 from office365.runtime.client_value_collection import ClientValueCollection
 
@@ -7,10 +10,20 @@ from office365.runtime.client_value_collection import ClientValueCollection
 class SynchronizationStatus(ClientValue):
     """Represents the current status of the synchronizationJob."""
 
-    def __init__(self, progress=None, quarantine=SynchronizationQuarantine()):
+    def __init__(
+        self,
+        progress=None,
+        quarantine=SynchronizationQuarantine(),
+        last_execution=SynchronizationTaskExecution(),
+        last_successful_execution=SynchronizationTaskExecution(),
+        last_successful_execution_with_exports=SynchronizationTaskExecution(),
+    ):
         """
         :param list[SynchronizationProgress] progress: Details of the progress of a job toward completion.
         :param SynchronizationQuarantine quarantine:
         """
         self.progress = ClientValueCollection(SynchronizationProgress, progress)
         self.quarantine = quarantine
+        self.lastExecution = last_execution
+        self.lastSuccessfulExecution = last_successful_execution
+        self.lastSuccessfulExecutionWithExports = last_successful_execution_with_exports

office365_rest_python_client-2.5.11/office365/directory/synchronization/task_execution.py

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class SynchronizationTaskExecution(ClientValue):
+    """Summarizes the results of the synchronization job run."""

{Office365-REST-Python-Client-2.5.10 → office365_rest_python_client-2.5.11}/office365/directory/users/user.py

@@ -1,6 +1,6 @@
 import json
 from datetime import datetime
-from typing import Optional
+from typing import List, Optional
 
 from office365.communications.onlinemeetings.collection import OnlineMeetingCollection
 from office365.communications.presences.presence import Presence
@@ -46,6 +46,7 @@ from office365.outlook.contacts.collection import ContactCollection
 from office365.outlook.contacts.folder import ContactFolder
 from office365.outlook.convert_id_result import ConvertIdResult
 from office365.outlook.mail.folders.collection import MailFolderCollection
+from office365.outlook.mail.item_body import ItemBody
 from office365.outlook.mail.mailbox_settings import MailboxSettings
 from office365.outlook.mail.messages.collection import MessageCollection
 from office365.outlook.mail.messages.message import Message
@@ -201,6 +202,7 @@ class User(DirectoryObject):
         bcc_recipients=None,
         save_to_sent_items=False,
     ):
+        # type: (str, str|ItemBody, List[str], List[str], List[str], bool) -> Message
         """Send a new message on the fly
 
         :param str subject: The subject of the message.
@@ -347,7 +349,7 @@ class User(DirectoryObject):
                 start_dt.isoformat(), end_dt.isoformat()
             )
 
-        self.context.add_query(qry).before_execute(_construct_request)
+        self.context.add_query(qry).before_query_execute(_construct_request)
         return return_type
 
     def get_reminder_view(self, start_dt, end_dt):

{Office365-REST-Python-Client-2.5.10 → office365_rest_python_client-2.5.11}/office365/graph_client.py

@@ -41,6 +41,7 @@ from office365.directory.users.collection import UserCollection
 from office365.directory.users.user import User
 from office365.education.root import EducationRoot
 from office365.entity_collection import EntityCollection
+from office365.graph_request import GraphRequest
 from office365.intune.devices.app_management import DeviceAppManagement
 from office365.intune.devices.collection import DeviceCollection
 from office365.intune.devices.management.management import DeviceManagement
@@ -58,7 +59,6 @@ from office365.runtime.auth.token_response import TokenResponse
 from office365.runtime.client_runtime_context import ClientRuntimeContext
 from office365.runtime.http.http_method import HttpMethod
 from office365.runtime.http.request_options import RequestOptions
-from office365.runtime.odata.request import ODataRequest
 from office365.runtime.odata.v4.batch_request import ODataV4BatchRequest
 from office365.runtime.odata.v4.json_format import V4JsonFormat
 from office365.runtime.paths.resource_path import ResourcePath
@@ -73,31 +73,14 @@ from office365.teams.collection import TeamCollection
 from office365.teams.template import TeamsTemplate
 from office365.teams.viva.employee_experience import EmployeeExperience
 
-environments_endpoints = {
-    "GCCH": {
-        "graph_url": "https://graph.microsoft.com",
-        "entra_url": "https://login.microsoftonline.com",
-    },
-    "GCC High": {
-        "graph_url": "https://graph.microsoft.us",
-        "entra_url": "https://login.microsoftonline.us",
-    },
-    "DoD": {
-        "graph_url": "https://dod-graph.microsoft.us",
-        "entra_url": "https://login.chinacloudapi.cn",
-    },
-}
-
 
 class GraphClient(ClientRuntimeContext):
     """Graph Service client"""
 
-    def __init__(self, acquire_token_callback, version="v1.0", environment="GCCH"):
-        # type: (Callable[[], dict], str, str) -> None
+    def __init__(self, acquire_token_callback):
+        # type: (Callable[[], dict]) -> None
         super(GraphClient, self).__init__()
         self._pending_request = None
-        self._version = version
-        self._environment_endpoints = environments_endpoints.get(environment, None)
         self._acquire_token_callback = acquire_token_callback
 
     @staticmethod
@@ -127,7 +110,7 @@ class GraphClient(ClientRuntimeContext):
                 "thumbprint": thumbprint,
                 "private_key": private_key,
             },
-            token_cache=token_cache  # Default cache is in memory only.
+            token_cache=token_cache,  # Default cache is in memory only.
             # You can learn how to use SerializableTokenCache from
             # https://msal-python.readthedocs.io/en/latest/#msal.SerializableTokenCache
         )
@@ -259,16 +242,16 @@ class GraphClient(ClientRuntimeContext):
         return self
 
     def pending_request(self):
-        # type: () -> ODataRequest
+        # type: () -> GraphRequest
         if self._pending_request is None:
-            self._pending_request = ODataRequest(V4JsonFormat())
+            self._pending_request = GraphRequest()
             self._pending_request.beforeExecute += self._authenticate_request
             self._pending_request.beforeExecute += self._build_specific_query
         return self._pending_request
 
     def service_root_url(self):
         # type: () -> str
-        return "https://graph.microsoft.com/{0}".format(self._version)
+        return self.pending_request().service_root_url
 
     def _build_specific_query(self, request):
         # type: (RequestOptions) -> None

office365_rest_python_client-2.5.11/office365/graph_request.py

@@ -0,0 +1,30 @@
+from office365.runtime.odata.request import ODataRequest
+from office365.runtime.odata.v4.json_format import V4JsonFormat
+
+environments_endpoints = {
+    "GCCH": {
+        "graph_url": "https://graph.microsoft.com",
+        "entra_url": "https://login.microsoftonline.com",
+    },
+    "GCC High": {
+        "graph_url": "https://graph.microsoft.us",
+        "entra_url": "https://login.microsoftonline.us",
+    },
+    "DoD": {
+        "graph_url": "https://dod-graph.microsoft.us",
+        "entra_url": "https://login.chinacloudapi.cn",
+    },
+}
+
+
+class GraphRequest(ODataRequest):
+    def __init__(self, version="v1.0", environment="GCCH"):
+        # type: (str, str) -> None
+        super(GraphRequest, self).__init__(V4JsonFormat())
+        self._version = version
+        self._environment_endpoints = environments_endpoints.get(environment, None)
+
+    @property
+    def service_root_url(self):
+        # type: () -> str
+        return "https://graph.microsoft.com/{0}".format(self._version)