710 lines
43 KiB
Ruby
710 lines
43 KiB
Ruby
# Copyright 2015 Google Inc.
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
|
|
require 'google/apis/core/base_service'
|
|
require 'google/apis/core/json_representation'
|
|
require 'google/apis/core/hashable'
|
|
require 'google/apis/errors'
|
|
|
|
module Google
|
|
module Apis
|
|
module ContentV2sandbox
|
|
# Content API for Shopping
|
|
#
|
|
# Manages product items, inventory, and Merchant Center accounts for Google
|
|
# Shopping.
|
|
#
|
|
# @example
|
|
# require 'google/apis/content_v2sandbox'
|
|
#
|
|
# Content = Google::Apis::ContentV2sandbox # Alias the module
|
|
# service = Content::ShoppingContentService.new
|
|
#
|
|
# @see https://developers.google.com/shopping-content
|
|
class ShoppingContentService < Google::Apis::Core::BaseService
|
|
# @return [String]
|
|
# API key. Your API key identifies your project and provides you with API access,
|
|
# quota, and reports. Required unless you provide an OAuth 2.0 token.
|
|
attr_accessor :key
|
|
|
|
# @return [String]
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# Overrides userIp if both are provided.
|
|
attr_accessor :quota_user
|
|
|
|
# @return [String]
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
attr_accessor :user_ip
|
|
|
|
def initialize
|
|
super('https://www.googleapis.com/', 'content/v2sandbox/')
|
|
@batch_path = 'batch'
|
|
end
|
|
|
|
# Marks an order as acknowledged. This method can only be called for non-multi-
|
|
# client accounts.
|
|
# @param [Fixnum] merchant_id
|
|
# The ID of the managing account.
|
|
# @param [String] order_id
|
|
# The ID of the order.
|
|
# @param [Google::Apis::ContentV2sandbox::OrdersAcknowledgeRequest] orders_acknowledge_request_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::ContentV2sandbox::OrdersAcknowledgeResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::ContentV2sandbox::OrdersAcknowledgeResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def acknowledge_order(merchant_id, order_id, orders_acknowledge_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, '{merchantId}/orders/{orderId}/acknowledge', options)
|
|
command.request_representation = Google::Apis::ContentV2sandbox::OrdersAcknowledgeRequest::Representation
|
|
command.request_object = orders_acknowledge_request_object
|
|
command.response_representation = Google::Apis::ContentV2sandbox::OrdersAcknowledgeResponse::Representation
|
|
command.response_class = Google::Apis::ContentV2sandbox::OrdersAcknowledgeResponse
|
|
command.params['merchantId'] = merchant_id unless merchant_id.nil?
|
|
command.params['orderId'] = order_id unless order_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Sandbox only. Moves a test order from state "inProgress" to state "
|
|
# pendingShipment". This method can only be called for non-multi-client accounts.
|
|
# @param [Fixnum] merchant_id
|
|
# The ID of the managing account.
|
|
# @param [String] order_id
|
|
# The ID of the test order to modify.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::ContentV2sandbox::OrdersAdvanceTestOrderResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::ContentV2sandbox::OrdersAdvanceTestOrderResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def advancetestorder_order(merchant_id, order_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, '{merchantId}/testorders/{orderId}/advance', options)
|
|
command.response_representation = Google::Apis::ContentV2sandbox::OrdersAdvanceTestOrderResponse::Representation
|
|
command.response_class = Google::Apis::ContentV2sandbox::OrdersAdvanceTestOrderResponse
|
|
command.params['merchantId'] = merchant_id unless merchant_id.nil?
|
|
command.params['orderId'] = order_id unless order_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Cancels all line items in an order, making a full refund. This method can only
|
|
# be called for non-multi-client accounts.
|
|
# @param [Fixnum] merchant_id
|
|
# The ID of the managing account.
|
|
# @param [String] order_id
|
|
# The ID of the order to cancel.
|
|
# @param [Google::Apis::ContentV2sandbox::OrdersCancelRequest] orders_cancel_request_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::ContentV2sandbox::OrdersCancelResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::ContentV2sandbox::OrdersCancelResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def cancel_order(merchant_id, order_id, orders_cancel_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, '{merchantId}/orders/{orderId}/cancel', options)
|
|
command.request_representation = Google::Apis::ContentV2sandbox::OrdersCancelRequest::Representation
|
|
command.request_object = orders_cancel_request_object
|
|
command.response_representation = Google::Apis::ContentV2sandbox::OrdersCancelResponse::Representation
|
|
command.response_class = Google::Apis::ContentV2sandbox::OrdersCancelResponse
|
|
command.params['merchantId'] = merchant_id unless merchant_id.nil?
|
|
command.params['orderId'] = order_id unless order_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Cancels a line item, making a full refund. This method can only be called for
|
|
# non-multi-client accounts.
|
|
# @param [Fixnum] merchant_id
|
|
# The ID of the managing account.
|
|
# @param [String] order_id
|
|
# The ID of the order.
|
|
# @param [Google::Apis::ContentV2sandbox::OrdersCancelLineItemRequest] orders_cancel_line_item_request_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::ContentV2sandbox::OrdersCancelLineItemResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::ContentV2sandbox::OrdersCancelLineItemResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def cancellineitem_order(merchant_id, order_id, orders_cancel_line_item_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, '{merchantId}/orders/{orderId}/cancelLineItem', options)
|
|
command.request_representation = Google::Apis::ContentV2sandbox::OrdersCancelLineItemRequest::Representation
|
|
command.request_object = orders_cancel_line_item_request_object
|
|
command.response_representation = Google::Apis::ContentV2sandbox::OrdersCancelLineItemResponse::Representation
|
|
command.response_class = Google::Apis::ContentV2sandbox::OrdersCancelLineItemResponse
|
|
command.params['merchantId'] = merchant_id unless merchant_id.nil?
|
|
command.params['orderId'] = order_id unless order_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Sandbox only. Creates a test order. This method can only be called for non-
|
|
# multi-client accounts.
|
|
# @param [Fixnum] merchant_id
|
|
# The ID of the managing account.
|
|
# @param [Google::Apis::ContentV2sandbox::OrdersCreateTestOrderRequest] orders_create_test_order_request_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::ContentV2sandbox::OrdersCreateTestOrderResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::ContentV2sandbox::OrdersCreateTestOrderResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def createtestorder_order(merchant_id, orders_create_test_order_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, '{merchantId}/testorders', options)
|
|
command.request_representation = Google::Apis::ContentV2sandbox::OrdersCreateTestOrderRequest::Representation
|
|
command.request_object = orders_create_test_order_request_object
|
|
command.response_representation = Google::Apis::ContentV2sandbox::OrdersCreateTestOrderResponse::Representation
|
|
command.response_class = Google::Apis::ContentV2sandbox::OrdersCreateTestOrderResponse
|
|
command.params['merchantId'] = merchant_id unless merchant_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves or modifies multiple orders in a single request. This method can
|
|
# only be called for non-multi-client accounts.
|
|
# @param [Google::Apis::ContentV2sandbox::OrdersCustomBatchRequest] orders_custom_batch_request_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::ContentV2sandbox::OrdersCustomBatchResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::ContentV2sandbox::OrdersCustomBatchResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def custombatch_order(orders_custom_batch_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'orders/batch', options)
|
|
command.request_representation = Google::Apis::ContentV2sandbox::OrdersCustomBatchRequest::Representation
|
|
command.request_object = orders_custom_batch_request_object
|
|
command.response_representation = Google::Apis::ContentV2sandbox::OrdersCustomBatchResponse::Representation
|
|
command.response_class = Google::Apis::ContentV2sandbox::OrdersCustomBatchResponse
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves an order from your Merchant Center account. This method can only be
|
|
# called for non-multi-client accounts.
|
|
# @param [Fixnum] merchant_id
|
|
# The ID of the managing account.
|
|
# @param [String] order_id
|
|
# The ID of the order.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::ContentV2sandbox::Order] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::ContentV2sandbox::Order]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_order(merchant_id, order_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, '{merchantId}/orders/{orderId}', options)
|
|
command.response_representation = Google::Apis::ContentV2sandbox::Order::Representation
|
|
command.response_class = Google::Apis::ContentV2sandbox::Order
|
|
command.params['merchantId'] = merchant_id unless merchant_id.nil?
|
|
command.params['orderId'] = order_id unless order_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves an order using merchant order id. This method can only be called for
|
|
# non-multi-client accounts.
|
|
# @param [Fixnum] merchant_id
|
|
# The ID of the managing account.
|
|
# @param [String] merchant_order_id
|
|
# The merchant order id to be looked for.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::ContentV2sandbox::OrdersGetByMerchantOrderIdResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::ContentV2sandbox::OrdersGetByMerchantOrderIdResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def getbymerchantorderid_order(merchant_id, merchant_order_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, '{merchantId}/ordersbymerchantid/{merchantOrderId}', options)
|
|
command.response_representation = Google::Apis::ContentV2sandbox::OrdersGetByMerchantOrderIdResponse::Representation
|
|
command.response_class = Google::Apis::ContentV2sandbox::OrdersGetByMerchantOrderIdResponse
|
|
command.params['merchantId'] = merchant_id unless merchant_id.nil?
|
|
command.params['merchantOrderId'] = merchant_order_id unless merchant_order_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Sandbox only. Retrieves an order template that can be used to quickly create a
|
|
# new order in sandbox. This method can only be called for non-multi-client
|
|
# accounts.
|
|
# @param [Fixnum] merchant_id
|
|
# The ID of the managing account.
|
|
# @param [String] template_name
|
|
# The name of the template to retrieve.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::ContentV2sandbox::OrdersGetTestOrderTemplateResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::ContentV2sandbox::OrdersGetTestOrderTemplateResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def gettestordertemplate_order(merchant_id, template_name, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, '{merchantId}/testordertemplates/{templateName}', options)
|
|
command.response_representation = Google::Apis::ContentV2sandbox::OrdersGetTestOrderTemplateResponse::Representation
|
|
command.response_class = Google::Apis::ContentV2sandbox::OrdersGetTestOrderTemplateResponse
|
|
command.params['merchantId'] = merchant_id unless merchant_id.nil?
|
|
command.params['templateName'] = template_name unless template_name.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists the orders in your Merchant Center account. This method can only be
|
|
# called for non-multi-client accounts.
|
|
# @param [Fixnum] merchant_id
|
|
# The ID of the managing account.
|
|
# @param [Boolean] acknowledged
|
|
# Obtains orders that match the acknowledgement status. When set to true,
|
|
# obtains orders that have been acknowledged. When false, obtains orders that
|
|
# have not been acknowledged.
|
|
# We recommend using this filter set to false, in conjunction with the
|
|
# acknowledge call, such that only un-acknowledged orders are returned.
|
|
# @param [Fixnum] max_results
|
|
# The maximum number of orders to return in the response, used for paging. The
|
|
# default value is 25 orders per page, and the maximum allowed value is 250
|
|
# orders per page.
|
|
# Known issue: All List calls will return all Orders without limit regardless of
|
|
# the value of this field.
|
|
# @param [String] order_by
|
|
# The ordering of the returned list. The only supported value are placedDate
|
|
# desc and placedDate asc for now, which returns orders sorted by placement date.
|
|
# "placedDate desc" stands for listing orders by placement date, from oldest to
|
|
# most recent. "placedDate asc" stands for listing orders by placement date,
|
|
# from most recent to oldest. In future releases we'll support other sorting
|
|
# criteria.
|
|
# @param [String] page_token
|
|
# The token returned by the previous request.
|
|
# @param [String] placed_date_end
|
|
# Obtains orders placed before this date (exclusively), in ISO 8601 format.
|
|
# @param [String] placed_date_start
|
|
# Obtains orders placed after this date (inclusively), in ISO 8601 format.
|
|
# @param [Array<String>, String] statuses
|
|
# Obtains orders that match any of the specified statuses. Multiple values can
|
|
# be specified with comma separation. Additionally, please note that active is a
|
|
# shortcut for pendingShipment and partiallyShipped, and completed is a shortcut
|
|
# for shipped , partiallyDelivered, delivered, partiallyReturned, returned, and
|
|
# canceled.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::ContentV2sandbox::OrdersListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::ContentV2sandbox::OrdersListResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_orders(merchant_id, acknowledged: nil, max_results: nil, order_by: nil, page_token: nil, placed_date_end: nil, placed_date_start: nil, statuses: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, '{merchantId}/orders', options)
|
|
command.response_representation = Google::Apis::ContentV2sandbox::OrdersListResponse::Representation
|
|
command.response_class = Google::Apis::ContentV2sandbox::OrdersListResponse
|
|
command.params['merchantId'] = merchant_id unless merchant_id.nil?
|
|
command.query['acknowledged'] = acknowledged unless acknowledged.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['placedDateEnd'] = placed_date_end unless placed_date_end.nil?
|
|
command.query['placedDateStart'] = placed_date_start unless placed_date_start.nil?
|
|
command.query['statuses'] = statuses unless statuses.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Refund a portion of the order, up to the full amount paid. This method can
|
|
# only be called for non-multi-client accounts.
|
|
# @param [Fixnum] merchant_id
|
|
# The ID of the managing account.
|
|
# @param [String] order_id
|
|
# The ID of the order to refund.
|
|
# @param [Google::Apis::ContentV2sandbox::OrdersRefundRequest] orders_refund_request_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::ContentV2sandbox::OrdersRefundResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::ContentV2sandbox::OrdersRefundResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def refund_order(merchant_id, order_id, orders_refund_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, '{merchantId}/orders/{orderId}/refund', options)
|
|
command.request_representation = Google::Apis::ContentV2sandbox::OrdersRefundRequest::Representation
|
|
command.request_object = orders_refund_request_object
|
|
command.response_representation = Google::Apis::ContentV2sandbox::OrdersRefundResponse::Representation
|
|
command.response_class = Google::Apis::ContentV2sandbox::OrdersRefundResponse
|
|
command.params['merchantId'] = merchant_id unless merchant_id.nil?
|
|
command.params['orderId'] = order_id unless order_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Returns a line item. This method can only be called for non-multi-client
|
|
# accounts.
|
|
# @param [Fixnum] merchant_id
|
|
# The ID of the managing account.
|
|
# @param [String] order_id
|
|
# The ID of the order.
|
|
# @param [Google::Apis::ContentV2sandbox::OrdersReturnLineItemRequest] orders_return_line_item_request_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::ContentV2sandbox::OrdersReturnLineItemResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::ContentV2sandbox::OrdersReturnLineItemResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def returnlineitem_order(merchant_id, order_id, orders_return_line_item_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, '{merchantId}/orders/{orderId}/returnLineItem', options)
|
|
command.request_representation = Google::Apis::ContentV2sandbox::OrdersReturnLineItemRequest::Representation
|
|
command.request_object = orders_return_line_item_request_object
|
|
command.response_representation = Google::Apis::ContentV2sandbox::OrdersReturnLineItemResponse::Representation
|
|
command.response_class = Google::Apis::ContentV2sandbox::OrdersReturnLineItemResponse
|
|
command.params['merchantId'] = merchant_id unless merchant_id.nil?
|
|
command.params['orderId'] = order_id unless order_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Marks line item(s) as shipped. This method can only be called for non-multi-
|
|
# client accounts.
|
|
# @param [Fixnum] merchant_id
|
|
# The ID of the managing account.
|
|
# @param [String] order_id
|
|
# The ID of the order.
|
|
# @param [Google::Apis::ContentV2sandbox::OrdersShipLineItemsRequest] orders_ship_line_items_request_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::ContentV2sandbox::OrdersShipLineItemsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::ContentV2sandbox::OrdersShipLineItemsResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def shiplineitems_order(merchant_id, order_id, orders_ship_line_items_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, '{merchantId}/orders/{orderId}/shipLineItems', options)
|
|
command.request_representation = Google::Apis::ContentV2sandbox::OrdersShipLineItemsRequest::Representation
|
|
command.request_object = orders_ship_line_items_request_object
|
|
command.response_representation = Google::Apis::ContentV2sandbox::OrdersShipLineItemsResponse::Representation
|
|
command.response_class = Google::Apis::ContentV2sandbox::OrdersShipLineItemsResponse
|
|
command.params['merchantId'] = merchant_id unless merchant_id.nil?
|
|
command.params['orderId'] = order_id unless order_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates the merchant order ID for a given order. This method can only be
|
|
# called for non-multi-client accounts.
|
|
# @param [Fixnum] merchant_id
|
|
# The ID of the managing account.
|
|
# @param [String] order_id
|
|
# The ID of the order.
|
|
# @param [Google::Apis::ContentV2sandbox::OrdersUpdateMerchantOrderIdRequest] orders_update_merchant_order_id_request_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::ContentV2sandbox::OrdersUpdateMerchantOrderIdResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::ContentV2sandbox::OrdersUpdateMerchantOrderIdResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def updatemerchantorderid_order(merchant_id, order_id, orders_update_merchant_order_id_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, '{merchantId}/orders/{orderId}/updateMerchantOrderId', options)
|
|
command.request_representation = Google::Apis::ContentV2sandbox::OrdersUpdateMerchantOrderIdRequest::Representation
|
|
command.request_object = orders_update_merchant_order_id_request_object
|
|
command.response_representation = Google::Apis::ContentV2sandbox::OrdersUpdateMerchantOrderIdResponse::Representation
|
|
command.response_class = Google::Apis::ContentV2sandbox::OrdersUpdateMerchantOrderIdResponse
|
|
command.params['merchantId'] = merchant_id unless merchant_id.nil?
|
|
command.params['orderId'] = order_id unless order_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates a shipment's status, carrier, and/or tracking ID. This method can only
|
|
# be called for non-multi-client accounts.
|
|
# @param [Fixnum] merchant_id
|
|
# The ID of the managing account.
|
|
# @param [String] order_id
|
|
# The ID of the order.
|
|
# @param [Google::Apis::ContentV2sandbox::OrdersUpdateShipmentRequest] orders_update_shipment_request_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::ContentV2sandbox::OrdersUpdateShipmentResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::ContentV2sandbox::OrdersUpdateShipmentResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def updateshipment_order(merchant_id, order_id, orders_update_shipment_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, '{merchantId}/orders/{orderId}/updateShipment', options)
|
|
command.request_representation = Google::Apis::ContentV2sandbox::OrdersUpdateShipmentRequest::Representation
|
|
command.request_object = orders_update_shipment_request_object
|
|
command.response_representation = Google::Apis::ContentV2sandbox::OrdersUpdateShipmentResponse::Representation
|
|
command.response_class = Google::Apis::ContentV2sandbox::OrdersUpdateShipmentResponse
|
|
command.params['merchantId'] = merchant_id unless merchant_id.nil?
|
|
command.params['orderId'] = order_id unless order_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
protected
|
|
|
|
def apply_command_defaults(command)
|
|
command.query['key'] = key unless key.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
end
|
|
end
|
|
end
|
|
end
|
|
end
|