আপনি আপনার মার্চেন্ট সেন্টার অ্যাকাউন্ট এবং অন্যান্য পরিষেবা প্রদানকারীদের মধ্যেকার সম্পর্ক পরিচালনা করতে অ্যাকাউন্টস এপিআই (Accounts API) ব্যবহার করতে পারেন। সম্পর্ক হলো একটি আনুষ্ঠানিক সংযোগ যা কোনো প্রদানকারীকে আপনার ব্যবসাকে নির্দিষ্ট পরিষেবা দেওয়ার সুযোগ করে দেয়। একটি পরিষেবা প্রদানকারীকে দেওয়া অনুমতি ও সক্ষমতা নির্ধারণ করে, যেমন পণ্য ব্যবস্থাপনা বা ক্যাম্পেইন ব্যবস্থাপনা। উদাহরণস্বরূপ, আপনার মার্চেন্ট সেন্টার অ্যাকাউন্টকে একটি গুগল অ্যাডস অ্যাকাউন্টের সাথে লিঙ্ক করলে, সেই অ্যাডস অ্যাকাউন্টটি বিজ্ঞাপন ক্যাম্পেইন চালানোর জন্য আপনার পণ্যের ডেটা ব্যবহার করতে পারে।
একটি সম্পর্ক নিম্নলিখিত বৈশিষ্ট্যগুলো দ্বারা গঠিত:
- মার্চেন্ট সেন্টার অ্যাকাউন্টটি পরিষেবাটি গ্রহণ করছে
- পরিষেবা প্রদানকারী
- মার্চেন্ট সেন্টার অ্যাকাউন্টে যে পরিষেবা বা পরিষেবাসমূহ প্রদান করা হচ্ছে
ছদ্মনাম
পরিষেবা প্রদানকারীরা তাদের পরিষেবা দেওয়া অ্যাকাউন্টগুলির সাথে একটি অ্যালিয়াস যুক্ত করতে পারেন (এটি Content API for Shopping-এর অ্যাকাউন্ট রিসোর্সে থাকা seller_id ফিল্ডের সমতুল্য)। AccountRelationship রিসোর্সের মধ্যে থাকা ঐচ্ছিক account_id_alias ফিল্ড ব্যবহার করে অ্যালিয়াসটি নির্ধারণ করা যায় এবং এটি একটি কাস্টম আইডেন্টিফায়ার হিসেবে কাজ করে। অ্যালিয়াসটিতে অবশ্যই ASCII অক্ষর, দশমিক সংখ্যা, হাইফেন, আন্ডারস্কোর, পিরিয়ড বা টিল্ড ( [A-Za-z0-9_~.-]{1,50} ) থেকে বেছে নেওয়া ১ থেকে ৫০টি অক্ষর থাকতে হবে।
কোনো অ্যাকাউন্টের অ্যালিয়াস ব্যবহার করে সেটি অ্যাক্সেস করার জন্য URL কাঠামোটি হলো GET /accounts/v1/accounts/{provider}~{account_id_alias} ।
পরিষেবা
অ্যাকাউন্টস এপিআই-তে, অ্যাকাউন্টগুলো নিম্নলিখিত সার্ভিসগুলো পেতে পারে। অ্যাকাউন্ট তৈরির সময় আপনি এই সার্ভিসগুলোর অনেকগুলোই যোগ করতে পারেন।
অ্যাকাউন্ট অ্যাগ্রিগেশন : এই পরিষেবাটি একটি অ্যাডভান্সড অ্যাকাউন্টকে অন্য একটি অ্যাকাউন্টের সাথে সংযুক্ত করে, যার ফলে অ্যাডভান্সড অ্যাকাউন্টটি সম্পূর্ণ ও অবাধ অ্যাক্সেস পায়। এটি সাধারণত মার্কেটপ্লেস, মাল্টি-ব্র্যান্ড রিটেইলার বা আন্তর্জাতিক রিটেইলাররা ব্যবহার করেন, যাদের নেস্টেড অ্যাকাউন্টগুলোর ওপর কেন্দ্রীভূত নিয়ন্ত্রণ প্রয়োজন। আপনি যদি কোনো ইকমার্স প্ল্যাটফর্ম বা চ্যানেল পার্টনার হন, তবে আমরা এর পরিবর্তে
accountManagementব্যবহার করার পরামর্শ দিই। অ্যাকাউন্ট অ্যাগ্রিগেশন ব্যবহার করে অ্যাকাউন্ট তৈরি করার সময়,externalAccountIdঅবশ্যই বাদ দিতে হবে।ক্যাম্পেইন ম্যানেজমেন্ট : এই পরিষেবাটি একটি মার্চেন্ট সেন্টার অ্যাকাউন্ট এবং একটি গুগল অ্যাডস অ্যাকাউন্টের মধ্যে সংযোগ স্থাপন করে, যা অ্যাডস অ্যাকাউন্টকে বিজ্ঞাপন ক্যাম্পেইন চালানোর জন্য প্রয়োজনীয় পণ্য এবং অ্যাকাউন্টের ডেটা অ্যাক্সেস করার সুযোগ দেয়। এক্ষেত্রে পরিষেবা প্রদানকারী হলো
GOOGLE_ADSএবংexternalAccountIdহলো গুগল অ্যাডস অ্যাকাউন্টের আইডি। এই পরিষেবাটি একটি বিদ্যমান অ্যাকাউন্টেও প্রস্তাব করা যেতে পারে।
তুলনামূলক কেনাকাটা : এটি এমন একটি তুলনামূলক কেনাকাটা পরিষেবা (CSS)-এর সাথে সম্পর্ককে বোঝায়, যা মার্চেন্ট সেন্টার অ্যাকাউন্টটি পরিচালনা করে।
স্থানীয় লিস্টিং ব্যবস্থাপনা : এর মাধ্যমে গুগল বিজনেস প্রোফাইল ব্যবহার করে স্থানীয় ইনভেন্টরি ও লিস্টিং ব্যবস্থাপনার জন্য একজন স্টোর ম্যানেজারের সাথে সম্পর্ক স্থাপন করা হয়।
অ্যাকাউন্ট ম্যানেজমেন্ট : এই পরিষেবাটি প্রোভাইডারকে মার্চেন্ট সেন্টার অ্যাকাউন্টে প্রশাসনিক কাজ করার সুযোগ দেয়, যেমন অ্যাকাউন্টের সেটিংস কনফিগার করা, ব্যবহারকারী পরিচালনা করা বা ব্যবসার তথ্য আপডেট করা। ব্যবসাটি প্রদত্ত অ্যাক্সেস সীমাবদ্ধও করতে পারে। অ্যাকাউন্ট তৈরির সময় ব্যবহার করা হলে, এই পরিষেবাটি প্রোভাইডারের সাথে লিঙ্কযুক্ত একটি অ্যাকাউন্ট তৈরি করে, যা ইকমার্স প্ল্যাটফর্ম এবং চ্যানেল পার্টনারদের জন্য প্রস্তাবিত পদ্ধতি। এটি একটি বিদ্যমান অ্যাকাউন্টেও প্রস্তাব করা যেতে পারে।
পণ্য ব্যবস্থাপনা : এই পরিষেবাটি প্রোভাইডারদের পণ্য এবং ডেটা সোর্স ও রুলসের মতো সংশ্লিষ্ট ফিচারগুলো পরিচালনা করার সুযোগ দেয়। অ্যাকাউন্ট তৈরির সময় যোগ করা হলে, এটি সাধারণত
accountManagementবাaccountAggregationসাথে একত্রে থাকে। এই পরিষেবাটি একটি বিদ্যমান অ্যাকাউন্টের জন্যও প্রস্তাব করা যেতে পারে।
করমর্দন
একটি পরিষেবা স্থাপন করতে, পরিষেবা প্রদানকারী অ্যাকাউন্ট এবং পরিষেবা গ্রহণকারী অ্যাকাউন্ট উভয়কেই সংযোগটি অনুমোদন করতে হবে। এই অনুমোদন প্রক্রিয়াটিকে হ্যান্ডশেক বলা হয়।
করমর্দন একটি দুই-ধাপের প্রক্রিয়া:
- এক পক্ষ একটি পরিষেবা সংযোগের প্রস্তাব দেয়।
- অপর পক্ষ প্রস্তাবটি অনুমোদন বা প্রত্যাখ্যান করে।
একবার কোনো প্রস্তাব গৃহীত হলে, পরিষেবাটি অনুমোদিত এবং সম্পূর্ণরূপে প্রতিষ্ঠিত বলে বিবেচিত হয়। পরিষেবা প্রদানকারীকে প্রদত্ত যেকোনো প্রবেশাধিকার এখন যোগ্য ব্যবহারকারীদের প্রদান করা হয় (নিচে প্রবেশাধিকার দেখুন)।
মনে রাখবেন যে, যে ব্যবহারকারী প্রস্তাব তৈরি করছেন, প্রত্যাখ্যান করছেন বা অনুমোদন করছেন, প্রক্রিয়াটি শুরু করা অ্যাকাউন্টে তার অবশ্যই ADMIN অ্যাক্সেস অধিকার থাকতে হবে। সুতরাং, যদি পরিষেবা প্রদানকারী কোনো পরিষেবার প্রস্তাব দেয়, তাহলে প্রস্তাবকারী ব্যবহারকারীকে অবশ্যই পরিষেবা প্রদানকারীর অ্যাকাউন্টে ADMIN হতে হবে এবং প্রস্তাব গ্রহণকারী বা প্রত্যাখ্যানকারী ব্যবহারকারীকে অবশ্যই গ্রহণকারী অ্যাকাউন্টে ADMIN হতে হবে।
নিম্নলিখিত নমুনাগুলি দেখায় কিভাবে একটি অ্যাকাউন্ট পরিষেবা প্রস্তাব করতে হয়:
জাভা
import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1.AccountName;
import com.google.shopping.merchant.accounts.v1.AccountService;
import com.google.shopping.merchant.accounts.v1.AccountServicesServiceClient;
import com.google.shopping.merchant.accounts.v1.AccountServicesServiceSettings;
import com.google.shopping.merchant.accounts.v1.ProductsManagement;
import com.google.shopping.merchant.accounts.v1.ProposeAccountServiceRequest;
import shopping.merchant.samples.utils.Authenticator;
/** This class demonstrates how to propose a service to an existing Merchant Center account. */
public class ProposeServiceSample {
public static void proposeService(long accountId, long providerId, String externalAccountId)
throws Exception {
// Obtains OAuth token based on the user's configuration.
// The user that authenticates should have access to the account.
GoogleCredentials credential = new Authenticator().authenticate();
// Creates service settings using the credentials retrieved above.
AccountServicesServiceSettings accountServicesServiceSettings =
AccountServicesServiceSettings.newBuilder()
.setCredentialsProvider(FixedCredentialsProvider.create(credential))
.build();
// Calls the API and catches and prints any network failures/errors.
try (AccountServicesServiceClient accountServicesServiceClient =
AccountServicesServiceClient.create(accountServicesServiceSettings)) {
// The service to be proposed.
// This sample shows how to propose product management.
// For more information about the different services, see:
// https://developers.google.com/merchant/api/guides/accounts/services
AccountService accountService =
AccountService.newBuilder()
.setProductsManagement(ProductsManagement.newBuilder().build())
.setExternalAccountId(externalAccountId)
.build();
String accountName =
AccountName.newBuilder().setAccount(String.valueOf(accountId)).build().toString();
ProposeAccountServiceRequest request =
ProposeAccountServiceRequest.newBuilder()
.setParent(accountName)
.setProvider("accounts/" + providerId)
.setAccountService(accountService)
.build();
System.out.println("Sending Propose Service request:");
AccountService response = accountServicesServiceClient.proposeAccountService(request);
System.out.println("Proposed Service below");
System.out.println(response);
} catch (Exception e) {
System.out.println(e);
}
}
public static void main(String[] args) throws Exception {
// The ID of the account to propose the service to.
long accountId = 123L;
// This is the provider ID of the e-commerce platform.
long providerId = 456L;
// An external ID that uniquely identifies the account service.
String externalAccountId = "ext-acc-id-123";
proposeService(accountId, providerId, externalAccountId);
}
}
পিএইচপি
require_once __DIR__ . '/../../../../vendor/autoload.php';
require_once __DIR__ . '/../../../Authentication/Authentication.php';
require_once __DIR__ . '/../../../Authentication/Config.php';
use Google\ApiCore\ApiException;
use Google\Shopping\Merchant\Accounts\V1\AccountAggregation;
use Google\Shopping\Merchant\Accounts\V1\AccountService;
use Google\Shopping\Merchant\Accounts\V1\Client\AccountServicesServiceClient;
use Google\Shopping\Merchant\Accounts\V1\ProposeAccountServiceRequest;
/**
* This class demonstrates how to propose an account service.
*/
class ProposeAccountServiceSample
{
/**
* A helper function to create the account name string.
*
* @param string $accountId The ID of the account.
*
* @return string The account name has the format: `accounts/{account_id}`
*/
private static function toAccountName(string $accountId): string
{
return sprintf('accounts/%s', $accountId);
}
/**
* Proposes a new account service.
*
* @param array $config The configuration data used for authentication and
* getting the account ID.
* @param string $providerId The ID of the provider account.
*/
public static function proposeAccountService(
array $config,
string $providerId
): void {
// Gets the OAuth credentials to make the request.
$credentials = Authentication::useServiceAccountOrTokenFile();
// Creates options containing credentials for the client to use.
$options = ['credentials' => $credentials];
// Creates a client.
$accountServicesServiceClient = new AccountServicesServiceClient($options);
// Calls the API and catches and prints any network failures/errors.
try {
$accountAggregation = new AccountAggregation();
$accountService = (new AccountService())
->setAccountAggregation($accountAggregation);
$request = (new ProposeAccountServiceRequest())
->setParent(self::toAccountName($config['accountId']))
->setProvider(self::toAccountName($providerId))
->setAccountService($accountService);
print "Sending Propose AccountService request\n";
$response = $accountServicesServiceClient->proposeAccountService($request);
print "Proposed AccountService below\n";
print $response->serializeToJsonString(true) . PHP_EOL;
} catch (ApiException $e) {
printf("An error has occurred: %s%s", $e->getMessage(), PHP_EOL);
}
}
/**
* Helper to execute the sample.
*/
public function callSample(): void
{
$config = Config::generateConfig();
// Update this with the Merchant Center provider ID you want to get the
// relationship for.
$providerId = 111;
self::proposeAccountService($config, $providerId);
}
}
// Run the script
$sample = new ProposeAccountServiceSample();
$sample->callSample();
পাইথন
"""This class demonstrates how to propose an account service."""
from examples.authentication import configuration
from examples.authentication import generate_user_credentials
from google.shopping.merchant_accounts_v1 import AccountAggregation
from google.shopping.merchant_accounts_v1 import AccountService
from google.shopping.merchant_accounts_v1 import AccountServicesServiceClient
from google.shopping.merchant_accounts_v1 import ProposeAccountServiceRequest
_ACCOUNT = configuration.Configuration().read_merchant_info()
_PARENT = f"accounts/{_ACCOUNT}"
def propose_account_service(provider_id: int) -> None:
"""Proposes an account service.
Args:
provider_id: The Merchant Center ID of the provider.
"""
# Gets OAuth Credentials.
credentials = generate_user_credentials.main()
# Creates a client.
client = AccountServicesServiceClient(credentials=credentials)
# Creates the provider resource name from the provider ID.
provider = f"accounts/{provider_id}"
# Creates an AccountService object.
# For this request, only `account_aggregation` is needed.
account_service = AccountService()
account_service.account_aggregation = AccountAggregation()
# Creates the request.
request = ProposeAccountServiceRequest(
parent=_PARENT,
provider=provider,
account_service=account_service,
)
# Makes the request and catches and prints any error messages.
try:
print("Sending Propose AccountService request")
response = client.propose_account_service(request=request)
print("Proposed AccountService below")
print(response)
except RuntimeError as e:
print(e)
if __name__ == "__main__":
# Update this with the Merchant Center provider ID you want to get the
# relationship for.
provider_id_ = 111
propose_account_service(provider_id_)
পরিষেবা-নির্দিষ্ট হ্যান্ডশেক আচরণ
নিম্নলিখিতে প্রতিটি পৃথক পরিষেবার জন্য নির্দিষ্ট করমর্দনের প্রয়োজনীয়তার বিবরণ দেওয়া হলো:
অ্যাকাউন্ট একত্রীকরণ : এই পরিষেবাটি শুধুমাত্র অ্যাকাউন্ট তৈরির অংশ হিসেবেই স্থাপন করা যায়। পরিষেবা প্রদানকারীকে একটি অ্যাডভান্সড অ্যাকাউন্টধারী হতে হবে এবং পরিষেবাটি স্বয়ংক্রিয়ভাবে অনুমোদিত হয়ে যায়, কারণ অ্যাডভান্সড অ্যাকাউন্টের ব্যবহারকারীদের তৈরি হতে থাকা অ্যাকাউন্টটিতে সম্পূর্ণ
ADMINঅ্যাক্সেস থাকে।তুলনা করে কেনাকাটা :
createAndConfigureব্যবহার করে অ্যাকাউন্ট তৈরির সময় এই পরিষেবাটি যোগ করা হলে তা স্বয়ংক্রিয়ভাবে অনুমোদিত হয়ে যায়।ক্যাম্পেইন ম্যানেজমেন্ট : যদিও এটি সাধারণ হ্যান্ডশেক প্রক্রিয়া অনুসরণ করে, প্রস্তাবনাগুলো একটি সিস্টেমে (যেমন গুগল অ্যাডস) করা হয় এবং অনুমোদনগুলো অন্য সিস্টেমে (যেমন মার্চেন্ট সেন্টার বা মার্চেন্ট এপিআই-এর মাধ্যমে) সম্পন্ন করা হয়।
লোকাল লিস্টিং ম্যানেজমেন্ট : এই পরিষেবার জন্য, একটি নির্দিষ্ট পদ্ধতিতে হ্যান্ডশেক করার প্রস্তাব করা হয় এবং অনুমোদনগুলো অন্য সিস্টেমে (যেমন গুগল বিজনেস প্রোফাইল) সম্পন্ন করা হয়। গুগল বিজনেস প্রোফাইল লিঙ্ক করার গাইডে বিস্তারিত ধাপগুলো দেওয়া আছে।
অ্যাকাউন্ট ব্যবস্থাপনা : এই পরিষেবার জন্য,
proposeব্যবহার করার সময় সাধারণ হ্যান্ডশেক প্রক্রিয়া প্রযোজ্য হয়। যদিcreateAndConfigureব্যবহার করে অ্যাকাউন্ট তৈরির সময় পরিষেবাটি যোগ করা হয়, তবে এটি স্বয়ংক্রিয়ভাবে অনুমোদিত হয়ে যায়।পণ্য ব্যবস্থাপনা : এই পরিষেবার জন্য, প্রচলিত সম্মতি প্রক্রিয়া প্রযোজ্য (এক পক্ষ প্রস্তাব দেয় এবং অপর পক্ষ তা গ্রহণ করে)।
প্রবেশাধিকার
প্রতিটি পরিষেবার ধরণ, পরিষেবা প্রদানকারীর ব্যবহারকারীদেরকে পরিষেবা দেওয়া অ্যাকাউন্টের উপর একটি নির্দিষ্ট স্তরের প্রবেশাধিকার প্রদান করে:
অ্যাকাউন্ট একত্রীকরণ : এই পরিষেবাটি সম্পূর্ণ
ADMINঅধিকার প্রদান করে।ক্যাম্পেইন ব্যবস্থাপনা : এই পরিষেবাটি একটি সীমিত প্রবেশাধিকার প্রদান করে, যার মাধ্যমে সংশ্লিষ্ট বিজ্ঞাপন অ্যাকাউন্টটি পণ্য এবং অ্যাকাউন্টের প্রাথমিক তথ্য দেখতে পারে।
তুলনা করে কেনাকাটা : এই পরিষেবাটি ডিফল্টরূপে সম্পূর্ণ
ADMINঅধিকার প্রদান করে। তবে, ব্যবসা প্রতিষ্ঠানটি মার্চেন্ট সেন্টারে প্রদত্ত অ্যাক্সেস সীমাবদ্ধ করতে পারে।স্থানীয় লিস্টিং ব্যবস্থাপনা : এই পরিষেবাটি সরাসরি অ্যাক্সেসের অধিকার প্রদান করে না। এর পরিবর্তে, এটি লিস্টিংটিকে তার পণ্যগুলিকে মার্চেন্ট সেন্টার অ্যাকাউন্টের সাথে সিঙ্ক্রোনাইজ করতে সক্ষম করে।
গুরুত্বপূর্ণ : নিম্নলিখিত পরিষেবা প্রকারগুলির জন্য বর্ণিত অ্যাক্সেস অধিকারগুলি শুধুমাত্র অনুমোদিত পরিষেবা প্রদানকারীদের জন্য প্রযোজ্য। আপনি যদি একজন পরিষেবা প্রদানকারী হন এবং এই সুবিধাটি ব্যবহার করতে চান, তাহলে আমাদের সহায়তা দলের সাথে যোগাযোগ করুন। আপনি যদি Content API for Shopping-এ পণ্য ব্যবস্থাপনার জন্য accounts.link পদ্ধতির জন্য পূর্বেই অনুমোদিত হয়ে থাকেন, তাহলে আপনি অতিরিক্ত অনুমোদন ছাড়াই Merchant API-তে এই পরিষেবাটি ব্যবহার করতে পারবেন।
অ্যাকাউন্ট ব্যবস্থাপনা : এই পরিষেবাটি ডিফল্টরূপে সম্পূর্ণ
ADMINঅধিকার প্রদান করে।পণ্য ব্যবস্থাপনা : এই পরিষেবাটি সম্পূর্ণ
ADMINঅধিকার প্রদান করে। উল্লেখ্য যে, ভবিষ্যতে এটি শুধুমাত্র পণ্য-সম্পর্কিত প্রবেশাধিকারের মধ্যে সীমাবদ্ধ থাকবে।
তৃতীয় পক্ষের প্ল্যাটফর্মের ক্ষেত্রে সম্পর্কগুলো কীভাবে প্রযোজ্য হয়
আপনি যদি এমন কোনো থার্ড-পার্টি প্ল্যাটফর্ম হন যা অন্যান্য ব্যবসার পক্ষ থেকে অ্যাকাউন্ট পরিচালনা করে, তাহলে বিভিন্ন ধারণাগুলো আপনার অ্যাকাউন্ট কাঠামোর সাথে কীভাবে খাপ খায় তা নিচে দেখানো হলো:
- পরিষেবা প্রদানকারী : আপনার উন্নত অ্যাকাউন্ট ।
- পরিষেবা গ্রহণকারী অ্যাকাউন্ট : একটি মার্চেন্ট সেন্টার অ্যাকাউন্ট যা আপনার পরিচালিত ব্যবসার প্রতিনিধিত্ব করে।
- পরিষেবা :
-
accountManagement: মার্চেন্টদের পক্ষ থেকে নতুন অ্যাকাউন্ট তৈরি করার জন্য ইকমার্স প্ল্যাটফর্ম এবং চ্যানেল পার্টনারদের জন্য এটি একটি প্রস্তাবিত পরিষেবা। এটি মার্চেন্টের মালিকানাধীন একটি অ্যাকাউন্ট তৈরি করে, যা পরিচালনার জন্য আপনার সাথে লিঙ্ক করা থাকে। এই ব্যবহারের ক্ষেত্রে এটি মার্চেন্ট সেন্টারের পছন্দের কাঠামোর সাথে সামঞ্জস্যপূর্ণ। -
accountAggregation: এই পরিষেবাটি আপনার অ্যাডভান্সড অ্যাকাউন্টকে অন্য একটি অ্যাকাউন্টের সাথে সংযুক্ত করে। এটি সমর্থিত হলেও, ই-কমার্স প্ল্যাটফর্ম এবং চ্যানেল পার্টনারদের জন্য এটি সুপারিশ করা হয় না।
-
কীভাবে একটি অ্যাডভান্সড অ্যাকাউন্ট সেট আপ করতে হয় এবং নতুন মার্চেন্ট সেন্টার অ্যাকাউন্টগুলো লিঙ্ক করতে হয়, সে সম্পর্কে বিস্তারিত জানতে ‘অ্যাকাউন্ট তৈরি করুন’ দেখুন।