Merge pull request #201 from notion-dotnet/feature/175-retrieve-page-property-item

Add support for Retrieve page property item endpoint

Author: KoditkarVedant

README.md

@@ -118,6 +118,7 @@ var complexFiler = new CompoundFilter(
   - [x] Retrieve a page
   - [x] Create a page
   - [x] Update page
+  - [x] Retrieve page property item
 - [x] Blocks
   - [x] Retrieve a block
   - [x] Update a block

Src/Notion.Client/Api/ApiEndpoints.cs

@@ -47,6 +47,14 @@ public static class PagesApiUrls
             public static string Retrieve(string pageId) => $"/v1/pages/{pageId}";
             public static string Update(string pageId) => $"/v1/pages/{pageId}";
             public static string UpdateProperties(string pageId) => $"/v1/pages/{pageId}";
+
+            /// <summary>
+            /// Get the <see cref="uri string"/> for retrieve page property item
+            /// </summary>
+            /// <param name="pageId">Identifier for a Notion Page</param>
+            /// <param name="propertyId">Identifier for a Notion Property</param>
+            /// <returns></returns>
+            public static string RetrievePropertyItem(string pageId, string propertyId) => $"/v1/pages/{pageId}/properties/{propertyId}";
         }
 
         public static class SearchApiUrls

Src/Notion.Client/Api/Pages/IPagesClient.cs

@@ -31,5 +31,12 @@ IDictionary<string, PropertyValue> updatedProperties
         /// <param name="pagesUpdateParameters"></param>
         /// <returns>Updated page.</returns>
         Task<Page> UpdateAsync(string pageId, PagesUpdateParameters pagesUpdateParameters);
+
+        /// <summary>
+        /// Retrieves a property_item object for a given pageId and propertyId. Depending on the property type, the object returned will either be a value or a paginated list of property item values.
+        /// </summary>
+        /// <param name="retrievePropertyItemParameters">sdf sd</param>
+        /// <returns><see cref="IPropertyItemObject"/></returns>
+        Task<IPropertyItemObject> RetrievePagePropertyItem(RetrievePropertyItemParameters retrievePropertyItemParameters);
     }
 }

Src/Notion.Client/Api/Pages/PagesClient.cs

@@ -51,6 +51,22 @@ public async Task<Page> RetrieveAsync(string pageId)
             return await _client.GetAsync<Page>(url);
         }
 
+        public async Task<IPropertyItemObject> RetrievePagePropertyItem(RetrievePropertyItemParameters retrievePropertyItemParameters)
+        {
+            var pathParameters = (IRetrievePropertyItemPathParameters)retrievePropertyItemParameters;
+            var queryParameters = (IRetrievePropertyQueryParameters)retrievePropertyItemParameters;
+
+            var url = PagesApiUrls.RetrievePropertyItem(pathParameters.PageId, pathParameters.PropertyId);
+
+            var queryParams = new Dictionary<string, string>()
+            {
+                { "start_cursor", queryParameters?.StartCursor },
+                { "page_size", queryParameters?.PageSize?.ToString() }
+            };
+
+            return await _client.GetAsync<IPropertyItemObject>(url, queryParams);
+        }
+
         public async Task<Page> UpdateAsync(string pageId, PagesUpdateParameters pagesUpdateParameters)
         {
             var url = PagesApiUrls.Update(pageId);

Src/Notion.Client/Api/Pages/RequestParams/RetrievePropertyItemParameters/IRetrievePropertyItemPathParameters.cs

@@ -0,0 +1,13 @@
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    public interface IRetrievePropertyItemPathParameters
+    {
+        [JsonProperty("page_id")]
+        string PageId { get; set; }
+
+        [JsonProperty("property_id")]
+        string PropertyId { get; set; }
+    }
+}

Src/Notion.Client/Api/Pages/RequestParams/RetrievePropertyItemParameters/IRetrievePropertyQueryParameters.cs

@@ -0,0 +1,6 @@
+namespace Notion.Client
+{
+    public interface IRetrievePropertyQueryParameters : IPaginationParameters
+    {
+    }
+}

Src/Notion.Client/Api/Pages/RequestParams/RetrievePropertyItemParameters/RetrievePropertyItemParameters.cs

@@ -0,0 +1,13 @@
+namespace Notion.Client
+{
+    public class RetrievePropertyItemParameters : IRetrievePropertyItemPathParameters, IRetrievePropertyQueryParameters
+    {
+        public string PageId { get; set; }
+
+        public string PropertyId { get; set; }
+
+        public string StartCursor { get; set; }
+
+        public int? PageSize { get; set; }
+    }
+}

Src/Notion.Client/Models/PropertyItems/CheckboxPropertyItem.cs

@@ -0,0 +1,12 @@
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    public class CheckboxPropertyItem : SimplePropertyItem
+    {
+        public override string Type => "checkbox";
+
+        [JsonProperty("checkbox")]
+        public bool Checkbox { get; set; }
+    }
+}

Src/Notion.Client/Models/PropertyItems/CreatedByPropertyItem.cs

@@ -0,0 +1,12 @@
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    public class CreatedByPropertyItem : SimplePropertyItem
+    {
+        public override string Type => "created_by";
+
+        [JsonProperty("created_by")]
+        public User CreatedBy { get; set; }
+    }
+}

Src/Notion.Client/Models/PropertyItems/CreatedTimePropertyItem.cs

@@ -0,0 +1,13 @@
+using System;
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    public class CreatedTimePropertyItem : SimplePropertyItem
+    {
+        public override string Type => "created_time";
+
+        [JsonProperty("created_time")]
+        public DateTime CreatedTime { get; set; }
+    }
+}