postproxy-sdk 1.8.0 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1d2f9ae8cbbc2ca3cd324b5dc522226c9d7a77cd93430abb309b31efc210a293
-  data.tar.gz: 26c58e5f9b7ea1af4eccb3935ef8c71bf202bf5bff93898d0b30a5450114bb1a
+  metadata.gz: 7b20d20d7dc1f6a386e74894a57e470c70a1edc3e95bcd61c3b25f02b3e457cd
+  data.tar.gz: 6fd6807bcbbd09fae222ccd07eee0d66cbb420bc04e83fd49ab98c4340a4ed82
 SHA512:
-  metadata.gz: 906800719560c2e37351c958fa72449d1411b351c1cad4deb0d312e9b6fcaa3af3be3dcb504eeef045a3d24737815afb4e7f772edae4687e102e2f9d4bd605cc
-  data.tar.gz: b6ee51b608b91a9d31ed2891b7bba87df996006be1795504f540e275dd54c8ff3b7ef7e5f1994a7aa495a02f67ec8f3921e9017baadb3e1e8d3c5550d6959b06
+  metadata.gz: c5e18b59805d1aff449eb7e3b8227bd2290b85994ba8e14f38b1c945381facd37a1b77e218d9eaf3c3e8c3183eade0da5268eb86b79762ad1aa9606b015a8e6a
+  data.tar.gz: ec5a37899a8c3622212e5d7d2b43a540df1e7aff64f9ea99a17a3fd1b0ed1e332a44a7c568eef24882f70fba267fe18302581d9af999ed997651df368dca59cc

data/README.md

@@ -317,6 +317,32 @@ client.comments.like("post-id", "comment-id", profile_id: "profile-id")
 client.comments.unlike("post-id", "comment-id", profile_id: "profile-id")
 ```
 
+## Profile comments (Google Business reviews)
+
+Profile-level comments expose Google Business reviews and replies. Reviews are user-generated — the SDK lets you list/get them and reply to or delete your own replies. Reviews sync twice daily.
+
+```ruby
+# List reviews for a profile (paginated)
+reviews = client.profile_comments.list("profile-id")
+reviews.data.each do |review|
+  rating = (review.platform_data || {})[:star_rating]
+  puts "#{review.author_username} #{rating}: #{review.body}"
+  review.replies.each { |r| puts "  reply: #{r.body}" }
+end
+
+# Filter by placement (location)
+reviews = client.profile_comments.list("profile-id", placement_id: "accounts/123/locations/456")
+
+# Get a single review
+review = client.profile_comments.get("profile-id", "review-id")
+
+# Reply to a review (parent_id is the review id)
+reply = client.profile_comments.create("profile-id", parent_id: "review-id", text: "Thanks for visiting!")
+
+# Delete your reply
+client.profile_comments.delete("profile-id", "reply-id")
+```
+
 ## Profiles
 
 ```ruby
@@ -435,7 +461,27 @@ post = client.posts.create(
 )
 ```
 
-Supported platforms: `facebook`, `instagram`, `tiktok`, `linkedin`, `youtube`, `twitter`, `threads`, `pinterest`, `bluesky`, `telegram`. Telegram requires a `chat_id` per post — list channels with `client.profiles.placements(profile_id)`.
+Supported platforms: `facebook`, `instagram`, `tiktok`, `linkedin`, `youtube`, `twitter`, `threads`, `pinterest`, `bluesky`, `telegram`, `google_business`. Telegram requires a `chat_id` per post — list channels with `client.profiles.placements(profile_id)`.
+
+### Google Business
+
+Google Business posts use a `google_business` entry in `PlatformParams` (a plain hash; no typed struct). The `location_id` is the location resource path returned by `client.profiles.placements()`. Supported formats: `standard`, `event`, `offer`. CTA actions: `LEARN_MORE`, `BOOK`, `ORDER`, `SHOP`, `SIGN_UP`, `CALL`. Media is limited to one image (≤5 MB).
+
+```ruby
+client.posts.create(
+  "Now open weekends!",
+  ["gbp-profile-id"],
+  media: ["https://example.com/store.jpg"],
+  platforms: {
+    google_business: {
+      format: "standard",
+      location_id: "accounts/123/locations/456",
+      cta_action_type: "LEARN_MORE",
+      cta_url: "https://example.com"
+    }
+  }
+)
+```
 
 ## Error Handling
 

data/lib/postproxy/client.rb

@@ -7,6 +7,7 @@ require_relative "resources/profile_groups"
 require_relative "resources/webhooks"
 require_relative "resources/queues"
 require_relative "resources/comments"
+require_relative "resources/profile_comments"
 
 module PostProxy
   class Client
@@ -23,6 +24,7 @@ module PostProxy
       @webhooks = nil
       @queues = nil
       @comments = nil
+      @profile_comments = nil
     end
 
     def posts
@@ -49,6 +51,10 @@ module PostProxy
       @comments ||= Resources::Comments.new(self)
     end
 
+    def profile_comments
+      @profile_comments ||= Resources::ProfileComments.new(self)
+    end
+
     def request(method, path, params: nil, json: nil, data: nil, files: nil, profile_group_id: nil)
       url = "/api#{path}"
 

data/lib/postproxy/constants.rb

@@ -2,7 +2,7 @@ module PostProxy
   DEFAULT_BASE_URL = "https://api.postproxy.dev"
 
   PLATFORMS = %w[
-    facebook instagram tiktok linkedin youtube twitter threads pinterest bluesky telegram
+    facebook instagram tiktok linkedin youtube twitter threads pinterest bluesky telegram google_business
   ].freeze
 
   PROFILE_STATUSES = %w[active expired inactive].freeze

data/lib/postproxy/resources/profile_comments.rb

@@ -0,0 +1,41 @@
+module PostProxy
+  module Resources
+    class ProfileComments
+      def initialize(client)
+        @client = client
+      end
+
+      def list(profile_id, placement_id: nil, page: nil, per_page: nil)
+        params = {}
+        params[:placement_id] = placement_id if placement_id
+        params[:page] = page if page
+        params[:per_page] = per_page if per_page
+
+        result = @client.request(:get, "/profiles/#{profile_id}/comments", params: params)
+        comments = (result[:data] || []).map { |c| ProfileComment.new(**c) }
+        PaginatedResponse.new(
+          data: comments,
+          total: result[:total],
+          page: result[:page],
+          per_page: result[:per_page]
+        )
+      end
+
+      def get(profile_id, comment_id)
+        result = @client.request(:get, "/profiles/#{profile_id}/comments/#{comment_id}")
+        ProfileComment.new(**result)
+      end
+
+      def create(profile_id, parent_id:, text:)
+        result = @client.request(:post, "/profiles/#{profile_id}/comments",
+                                 json: { parent_id: parent_id, text: text })
+        ProfileComment.new(**result)
+      end
+
+      def delete(profile_id, comment_id)
+        result = @client.request(:delete, "/profiles/#{profile_id}/comments/#{comment_id}")
+        AcceptedResponse.new(**result)
+      end
+    end
+  end
+end

data/lib/postproxy/types.rb

@@ -98,14 +98,31 @@ module PostProxy
     end
   end
 
+  class MediaPlatformError < Model
+    attr_accessor :platform, :status, :error, :error_details
+
+    def initialize(**attrs)
+      @error = nil
+      @error_details = nil
+      super
+      @error_details = ErrorDetails.new(**@error_details.transform_keys(&:to_sym)) if @error_details.is_a?(Hash)
+    end
+  end
+
   class Media < Model
-    attr_accessor :id, :status, :error_message, :content_type, :source_url, :url
+    attr_accessor :id, :status, :error_message, :content_type, :source_url, :url, :platforms
 
     def initialize(**attrs)
       @error_message = nil
       @source_url = nil
       @url = nil
+      @platforms = nil
       super
+      if @platforms.is_a?(Array)
+        @platforms = @platforms.map do |p|
+          p.is_a?(MediaPlatformError) ? p : MediaPlatformError.new(**p.transform_keys(&:to_sym))
+        end
+      end
     end
   end
 
@@ -322,6 +339,33 @@ module PostProxy
     end
   end
 
+  class ProfileComment < Model
+    attr_accessor :id, :external_id, :parent_external_id, :placement_id,
+                  :body, :status, :author_username, :author_avatar_url,
+                  :platform_data, :posted_at, :created_at, :replies
+
+    def initialize(**attrs)
+      @parent_external_id = nil
+      @author_username = nil
+      @author_avatar_url = nil
+      @platform_data = nil
+      @replies = []
+      super
+      @posted_at = parse_time(@posted_at)
+      @created_at = parse_time(@created_at)
+      @replies = (@replies || []).map do |r|
+        r.is_a?(ProfileComment) ? r : ProfileComment.new(**r.transform_keys(&:to_sym))
+      end
+    end
+
+    private
+
+    def parse_time(value)
+      return nil if value.nil?
+      value.is_a?(Time) ? value : Time.parse(value.to_s)
+    end
+  end
+
   class AcceptedResponse < Model
     attr_accessor :accepted
   end
@@ -452,11 +496,11 @@ module PostProxy
 
   class PlatformParams < Model
     attr_accessor :facebook, :instagram, :tiktok, :linkedin, :youtube,
-                  :pinterest, :threads, :twitter, :bluesky, :telegram
+                  :pinterest, :threads, :twitter, :bluesky, :telegram, :google_business
 
     def to_h
       result = {}
-      %i[facebook instagram tiktok linkedin youtube pinterest threads twitter bluesky telegram].each do |platform|
+      %i[facebook instagram tiktok linkedin youtube pinterest threads twitter bluesky telegram google_business].each do |platform|
         value = send(platform)
         next if value.nil?
 

data/lib/postproxy/version.rb

@@ -1,3 +1,3 @@
 module PostProxy
-  VERSION = "1.8.0"
+  VERSION = "1.9.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: postproxy-sdk
 version: !ruby/object:Gem::Version
-  version: 1.8.0
+  version: 1.9.0
 platform: ruby
 authors:
 - PostProxy
@@ -80,6 +80,7 @@ files:
 - lib/postproxy/errors.rb
 - lib/postproxy/resources/comments.rb
 - lib/postproxy/resources/posts.rb
+- lib/postproxy/resources/profile_comments.rb
 - lib/postproxy/resources/profile_groups.rb
 - lib/postproxy/resources/profiles.rb
 - lib/postproxy/resources/queues.rb