Merchant Center की सेवा की शर्तों से जुड़े कानूनी समझौतों को मैनेज करना

Merchant Center और इसकी सुविधाओं का इस्तेमाल करने के लिए, आपको अपने कारोबार की जगह के लिए, Merchant Center की सेवा की शर्तें (टीओएस) स्वीकार करनी होंगी. इन समझौतों में, Merchant Center की सेवाओं को इस्तेमाल करने की कानूनी शर्तें बताई गई हैं.

इस गाइड में बताया गया है कि इन कानूनी समझौतों को मैनेज करने के लिए, Merchant API का इस्तेमाल कैसे किया जा सकता है. इससे कोई फ़र्क़ नहीं पड़ता कि आपको अपने खाते के लिए कानूनी समझौते मैनेज करने हैं या उन खातों के लिए जिन्हें तीसरे पक्ष की सेवा देने वाली कंपनी (3P) के तौर पर मैनेज किया जाता है.

इससे ये सुविधाएं मिलती हैं:

  • किसी खाते के लिए, सेवा की शर्तों के कानूनी समझौते की मौजूदा स्थिति देखना.
  • कारोबारियों या कंपनियों को सेवा की ज़रूरी शर्तें स्वीकार करने के लिए कहें.
  • क्लाइंट खातों के लिए, सेवा देने वाली कंपनी के तौर पर सेवा की शर्तें मैनेज करना.

ज़रूरी शर्तें

Merchant API का इस्तेमाल करने के लिए, आपके पास Merchant Center खाता होना चाहिए. Merchant Center के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके खाता बनाने के बाद, उसमें बदलाव किए जा सकते हैं. जैसे, कारोबार की जानकारी अपडेट करना, उपयोगकर्ताओं को मैनेज करना वगैरह. इसके लिए, यूआई या एपीआई का इस्तेमाल किया जा सकता है.

अगर आपको कई खाते मैनेज करने हैं, तो Merchant API का इस्तेमाल करके क्लाइंट खाते बनाए जा सकते हैं. खाते बनाना देखें.

किसी खाते की सेवा की शर्तों के कानूनी समझौते की स्थिति देखना

कोई कारोबारी या कंपनी, Merchant Center का पूरी तरह से इस्तेमाल कर पाए, इसके लिए आपको सेवा की शर्तों के कानूनी समझौते की स्थिति देखनी होगी. इसके अलावा, अगर आपको समझौते की मौजूदा स्थिति की पुष्टि करनी है, तो भी आपको सेवा की शर्तों के कानूनी समझौते की स्थिति देखनी होगी.

Merchant Center ऐप्लिकेशन के लिए, सेवा की शर्तों के कानूनी समझौते की स्थिति जानने के लिए, termsOfServiceAgreementStates.retrieveForApplication तरीके का इस्तेमाल करें. इस तरीके से, आपकी मौजूदा सेवा की शर्तें दिखती हैं. अगर आपने सेवा की शर्तों को पिछली बार स्वीकार करने के बाद, उन्हें अपडेट किया गया है, तो आपको सेवा की शर्तों का नया वर्शन स्वीकार करना होगा.

अनुरोध का एक सैंपल यहां दिया गया है:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/termsOfServiceAgreementStates:retrieveForApplication

कॉल पूरा होने पर, TermsOfServiceAgreementState संसाधन दिखता है. इस संसाधन में ये चीज़ें शामिल हैं:

  • name: कानूनी समझौते की इस स्थिति का आइडेंटिफ़ायर.
  • regionCode: वह देश जहां कानूनी समझौते की यह स्थिति लागू होती है. आम तौर पर, यह वह देश होता है जहां खाते का कारोबार होता है.
  • termsOfServiceKind: यह MERCHANT_CENTER होगा.
  • accepted: सेवा की शर्तों के उस वर्शन के बारे में जानकारी जिसे खाते ने पहले ही स्वीकार कर लिया है. इसमें termsOfService संसाधन का नाम (जैसे, termsOfService/132) और इसे acceptedBy करने वाले व्यक्ति की जानकारी शामिल है. अगर सेवा की शर्तों का नया वर्शन required है, तो इसमें validUntil तारीख भी शामिल हो सकती है.
  • required: सेवा की शर्तों के उस वर्शन के बारे में जानकारी जिसे खाते के लिए स्वीकार करना ज़रूरी है. इसमें termsOfService संसाधन का नाम और tosFileUri शामिल है. यह, सेवा की शर्तों वाले दस्तावेज़ पर ले जाता है. इस दस्तावेज़ को कोई भी व्यक्ति आसानी से पढ़ सकता है.

जवाब का उदाहरण:

{
  "name": "accounts/{ACCOUNT_ID}/termsOfServiceAgreementStates/MERCHANT_CENTER-{REGION_CODE}",
  "regionCode": "{REGION_CODE}",
  "termsOfServiceKind": "MERCHANT_CENTER",
  "accepted": {
    "termsOfService": "termsOfService/132",
    "acceptedBy": "accounts/{ACCOUNT_ID}"
  },
  "required": {
    "termsOfService": "termsOfService/132",
    "tosFileUri": "https://www.google.com/intl/{REGION_CODE}/policies/merchants/terms/"
  }
}

अगर सेवा की नई शर्तें required हैं, तो कारोबारी या कंपनी को उन्हें स्वीकार करने के लिए कहें.

यहां एक सैंपल दिया गया है. इसका इस्तेमाल करके, किसी खाते और देश के लिए, सेवा की शर्तों के कानूनी समझौते की स्थिति को वापस पाया जा सकता है:

Java

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1.GetTermsOfServiceAgreementStateRequest;
import com.google.shopping.merchant.accounts.v1.TermsOfServiceAgreementState;
import com.google.shopping.merchant.accounts.v1.TermsOfServiceAgreementStateName;
import com.google.shopping.merchant.accounts.v1.TermsOfServiceAgreementStateServiceClient;
import com.google.shopping.merchant.accounts.v1.TermsOfServiceAgreementStateServiceSettings;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/**
 * This class demonstrates how to get a TermsOfServiceAgreementState for a specific
 * TermsOfServiceKind and country.
 */
public class GetTermsOfServiceAgreementStateSample {

  public static void getTermsOfServiceAgreementState(Config config) throws Exception {

    // Obtains OAuth token based on the user's configuration.
    GoogleCredentials credential = new Authenticator().authenticate();

    // Creates service settings using the credentials retrieved above.
    TermsOfServiceAgreementStateServiceSettings termsOfServiceAgreementStateServiceSettings =
        TermsOfServiceAgreementStateServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    // Creates TermsOfServiceAgreementState name to identify TermsOfServiceAgreementState.
    String name =
        TermsOfServiceAgreementStateName.newBuilder()
            .setAccount(config.getAccountId().toString())
            // The Identifier is: "{TermsOfServiceKind}-{country}"
            .setIdentifier("MERCHANT_CENTER-US")
            .build()
            .toString();

    System.out.println(name);

    // Calls the API and catches and prints any network failures/errors.
    try (TermsOfServiceAgreementStateServiceClient termsOfServiceAgreementStateServiceClient =
        TermsOfServiceAgreementStateServiceClient.create(
            termsOfServiceAgreementStateServiceSettings)) {

      // The name has the format:
      // accounts/{account}/termsOfServiceAgreementStates/{TermsOfServiceKind}-{country}
      GetTermsOfServiceAgreementStateRequest request =
          GetTermsOfServiceAgreementStateRequest.newBuilder().setName(name).build();

      System.out.println("Sending Get TermsOfServiceAgreementState request:");
      TermsOfServiceAgreementState response =
          termsOfServiceAgreementStateServiceClient.getTermsOfServiceAgreementState(request);

      System.out.println("Retrieved TermsOfServiceAgreementState below");
      // If the terms of service needs to be accepted, the "required" field will include the
      // specific version of the terms of service which needs to be accepted, alongside a link to
      // the terms of service itself.
      System.out.println(response);
    } catch (Exception e) {
      System.out.println(e);
    }
  }


  public static void main(String[] args) throws Exception {
    Config config = Config.load();

    getTermsOfServiceAgreementState(config);
  }
}

PHP

use Google\ApiCore\ApiException;
use Google\Shopping\Merchant\Accounts\V1\Client\TermsOfServiceAgreementStateServiceClient;
use Google\Shopping\Merchant\Accounts\V1\GetTermsOfServiceAgreementStateRequest;

/**
 * Demonstrates how to get a TermsOfServiceAgreementState.
 */
class GetTermsOfServiceAgreementState
{

    /**
     * Gets a TermsOfServiceAgreementState.
     *
     * @param array $config The configuration data.
     * @return void
     */
    public static function getTermsOfServiceAgreementState($config): void
    {
        // Get OAuth credentials.
        $credentials = Authentication::useServiceAccountOrTokenFile();

        // Create client options.
        $options = ['credentials' => $credentials];

        // Create a TermsOfServiceAgreementStateServiceClient.
        $termsOfServiceAgreementStateServiceClient = new TermsOfServiceAgreementStateServiceClient($options);

        // Service agreeement identifier
        $identifier = "MERCHANT_CENTER-US";

        // Create TermsOfServiceAgreementState name.
        $name = "accounts/" . $config['accountId'] . "/termsOfServiceAgreementStates/" . $identifier;

        print $name . PHP_EOL;

        try {
            // Prepare the request.
            $request = new GetTermsOfServiceAgreementStateRequest([
                'name' => $name,
            ]);

            print "Sending Get TermsOfServiceAgreementState request:" . PHP_EOL;
            $response = $termsOfServiceAgreementStateServiceClient->getTermsOfServiceAgreementState($request);

            print "Retrieved TermsOfServiceAgreementState below\n";
            print $response->serializeToJsonString() . PHP_EOL;
        } catch (ApiException $e) {
            print $e->getMessage();
        }
    }

    /**
     * Helper to execute the sample.
     *
     * @return void
     */
    public function callSample(): void
    {
        $config = Config::generateConfig();

        self::getTermsOfServiceAgreementState($config);
    }

}

// Run the script
$sample = new GetTermsOfServiceAgreementState();
$sample->callSample();

Python

from examples.authentication import configuration
from examples.authentication import generate_user_credentials
from google.shopping.merchant_accounts_v1 import GetTermsOfServiceAgreementStateRequest
from google.shopping.merchant_accounts_v1 import TermsOfServiceAgreementStateServiceClient

# Replace with your actual value.
_ACCOUNT_ID = configuration.Configuration().read_merchant_info()
_IDENTIFIER = "MERCHANT_CENTER-US"  # Replace with your identifier


def get_terms_of_service_agreement_state():
  """Gets a TermsOfServiceAgreementState for a specific TermsOfServiceKind and country."""

  credentials = generate_user_credentials.main()
  client = TermsOfServiceAgreementStateServiceClient(credentials=credentials)

  name = (
      "accounts/"
      + _ACCOUNT_ID
      + "/termsOfServiceAgreementStates/"
      + _IDENTIFIER
  )

  print(name)

  request = GetTermsOfServiceAgreementStateRequest(name=name)

  try:
    print("Sending Get TermsOfServiceAgreementState request:")
    response = client.get_terms_of_service_agreement_state(request=request)
    print("Retrieved TermsOfServiceAgreementState below")
    print(response)
  except RuntimeError as e:
    print(e)


if __name__ == "__main__":
  get_terms_of_service_agreement_state()

सेवा की शर्तें स्वीकार करें

Merchant Center की सुविधाओं का ऐक्सेस बनाए रखने के लिए, कारोबारियों या कंपनियों को सेवा की नई शर्तें स्वीकार करनी होंगी.

अपने खाते के लिए सेवा की शर्तें स्वीकार करें

अगर Merchant Center खाते को खुद मैनेज किया जाता है, तो यह तरीका अपनाएं:

  1. termsOfServiceAgreementStates.retrieveForApplication पर कॉल करें, ताकि यह पता लगाया जा सके कि सेवा की कोई शर्त required है या नहीं.
  2. अगर सेवा की शर्तें ज़रूरी हैं, तो required फ़ील्ड से termsOfService का नाम नोट करें. जैसे, termsOfService/132.

  3. सेवा की शर्तें स्वीकार करने के लिए, termsOfService.accept को कॉल करें. आपको सेवा की शर्तों का नाम, अपना ACCOUNT_ID, और retrieveForApplication से मिला regionCode देना होगा.

    अनुरोध का एक सैंपल यहां दिया गया है:

    POST https://merchantapi.googleapis.com/accounts/v1/{name={termsOfService/VERSION}}:accept
{
  "account": "accounts/{ACCOUNT_ID}",
  "regionCode": "{REGION_CODE}"
}

    कॉल सफल होने पर, जवाब के मुख्य हिस्से में कुछ नहीं दिखता. साथ ही, खाते की सेवा की शर्तों के कानूनी समझौते की स्थिति अपडेट हो जाती है.

सेवा की शर्तें स्वीकार करने के लिए, कारोबारियों या कंपनियों को गाइड करना (तीसरे पक्ष की सेवा देने वाली कंपनियों के लिए)

अगर आप तीसरे पक्ष की सेवा देने वाली कंपनी (3P) हैं और अन्य कारोबारों के लिए Merchant Center खाते मैनेज करती हैं, तो आपको उनकी ओर से सेवा की शर्तें स्वीकार नहीं करनी चाहिए. इसके बजाय, आपको ये काम करने चाहिए:

  1. सेवा की शर्तों का नया वर्शन पाना: कारोबारी या कंपनी के regionCode और MERCHANT_CENTER के लिए termsOfService.retrieveLatest को कॉल करें, ताकि सेवा की शर्तों के नए वर्शन की जानकारी मिल सके. कारोबारी या कंपनी को इस वर्शन को स्वीकार करना पड़ सकता है.

    अनुरोध का सैंपल:

    GET https://merchantapi.googleapis.com/accounts/v1/termsOfService:retrieveLatest?regionCode={REGION_CODE}&kind=MERCHANT_CENTER

    जवाब का उदाहरण:

    {
    "name": "{termsOfService/VERSION}",
    "regionCode": "{REGION_CODE}",
    "kind": "MERCHANT_CENTER",
    "fileUri": "https://www.google.com/intl/{REGION_CODE}/policies/merchants/terms/"
}

  2. सेवा की शर्तें दिखाएं: अपने ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई) में, कारोबारी या कंपनी को सेवा की शर्तों का पूरा टेक्स्ट दिखाने के लिए, जवाब में मिले fileUri का इस्तेमाल करें.

  3. कारोबारी या कंपनी की सहमति लें: कारोबारी या कंपनी को आपके यूज़र इंटरफ़ेस (यूआई) में दी गई शर्तों से साफ़ तौर पर सहमत होना चाहिए.

  4. एपीआई का इस्तेमाल करके, स्वीकार किए गए समझौते को रिकॉर्ड करना: कारोबारी या कंपनी के स्वीकार करने के बाद, पहले चरण में मिले टीओएस के name, कारोबारी या कंपनी के ACCOUNT_ID, और उनके regionCode का इस्तेमाल करके, termsOfService.accept को कॉल करें.

    अनुरोध का सैंपल:

    POST https://merchantapi.googleapis.com/accounts/v1/{name={termsOfService/VERSION}}:accept
{
  "account": "accounts/{MERCHANT_ACCOUNT_ID}",
  "regionCode": "{REGION_CODE}"
}

यहां एक सैंपल दिया गया है. इसका इस्तेमाल करके, किसी खाते के लिए सेवा की शर्तों के समझौते को स्वीकार किया जा सकता है. हालांकि, ऐसा कारोबारी या कंपनी की सहमति मिलने के बाद ही किया जा सकता है:

Java

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1.AcceptTermsOfServiceRequest;
import com.google.shopping.merchant.accounts.v1.TermsOfServiceServiceClient;
import com.google.shopping.merchant.accounts.v1.TermsOfServiceServiceSettings;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/** This class demonstrates how to accept the TermsOfService agreement in a given account. */
public class AcceptTermsOfServiceSample {

  public static void acceptTermsOfService(String accountId, String tosVersion, String regionCode)
      throws Exception {

    // Obtains OAuth token based on the user's configuration.
    GoogleCredentials credential = new Authenticator().authenticate();

    // Creates service settings using the credentials retrieved above.
    TermsOfServiceServiceSettings tosServiceSettings =
        TermsOfServiceServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    // Calls the API and catches and prints any network failures/errors.
    try (TermsOfServiceServiceClient tosServiceClient =
        TermsOfServiceServiceClient.create(tosServiceSettings)) {

      // The parent has the format: accounts/{account}
      AcceptTermsOfServiceRequest request =
          AcceptTermsOfServiceRequest.newBuilder()
              .setName(String.format("termsOfService/%s", tosVersion))
              .setAccount(String.format("accounts/%s", accountId))
              .setRegionCode(regionCode)
              .build();

      System.out.println("Sending request to accept terms of service...");
      tosServiceClient.acceptTermsOfService(request);

      System.out.println("Successfully accepted terms of service.");
    } catch (Exception e) {
      System.out.println(e);
    }
  }

  public static void main(String[] args) throws Exception {
    Config config = Config.load();

    // See GetTermsOfServiceAgreementStateSample to understand how to check which version of the
    // terms of service needs to be accepted, if any.
    // Likewise, if you know that the terms of service needs to be accepted, you can also simply
    // call RetrieveLatestTermsOfService to get the latest version of the terms of service.
    // Region code is either a country when the ToS applies specifically to that country or 001 when
    // it applies globally.
    acceptTermsOfService(config.getAccountId().toString(), "VERSION_HERE", "REGION_CODE_HERE");
  }
}

PHP

use Google\ApiCore\ApiException;
use Google\Shopping\Merchant\Accounts\V1\AcceptTermsOfServiceRequest;
use Google\Shopping\Merchant\Accounts\V1\Client\TermsOfServiceServiceClient;

/**
 * Demonstrates how to accept the TermsOfService agreement in a given account.
 */
class AcceptTermsOfService
{

    /**
     * Accepts the Terms of Service agreement.
     *
     * @param string $accountId The account ID.
     * @param string $tosVersion The Terms of Service version.
     * @param string $regionCode The region code.
     * @return void
     */
    public static function acceptTermsOfService($accountId, $tosVersion, $regionCode): void
    {
        // Get OAuth credentials.
        $credentials = Authentication::useServiceAccountOrTokenFile();

        // Create client options.
        $options = ['credentials' => $credentials];

        // Create a TermsOfServiceServiceClient.
        $tosServiceClient = new TermsOfServiceServiceClient($options);

        try {
            // Prepare the request.
            $request = new AcceptTermsOfServiceRequest([
                'name' => sprintf("termsOfService/%s", $tosVersion),
                'account' => sprintf("accounts/%s", $accountId),
                'region_code' => $regionCode,
            ]);

            print "Sending request to accept terms of service...\n";
            $tosServiceClient->acceptTermsOfService($request);

            print "Successfully accepted terms of service.\n";
        } catch (ApiException $e) {
            print $e->getMessage();
        }
    }

    /**
     * Helper to execute the sample.
     *
     * @return void
     */
    public function callSample(): void
    {
        $config = Config::generateConfig();

        // Replace with actual values.
        $tosVersion = "132";
        $regionCode = "US";

        self::acceptTermsOfService($config['accountId'], $tosVersion, $regionCode);
    }
}

// Run the script
$sample = new AcceptTermsOfService();
$sample->callSample();

Python

from examples.authentication import configuration
from examples.authentication import generate_user_credentials
from google.shopping.merchant_accounts_v1 import AcceptTermsOfServiceRequest
from google.shopping.merchant_accounts_v1 import TermsOfServiceServiceClient

# Replace with your actual values.
_ACCOUNT_ID = configuration.Configuration().read_merchant_info()
_TOS_VERSION = (  # Replace with the Terms of Service version to accept
    "VERSION_HERE"
)
_REGION_CODE = "US"  # Replace with the region code


def accept_terms_of_service():
  """Accepts the Terms of Service agreement for a given account."""

  credentials = generate_user_credentials.main()
  client = TermsOfServiceServiceClient(credentials=credentials)

  # Construct the request
  request = AcceptTermsOfServiceRequest(
      name=f"termsOfService/{_TOS_VERSION}",
      account=f"accounts/{_ACCOUNT_ID}",
      region_code=_REGION_CODE,
  )

  try:
    print("Sending request to accept terms of service...")
    client.accept_terms_of_service(request=request)
    print("Successfully accepted terms of service.")
  except RuntimeError as e:
    print(e)


if __name__ == "__main__":
  accept_terms_of_service()

तीसरे पक्ष की कंपनियों के लिए, ध्यान देने लायक खास बातें

तीसरे पक्ष की सेवा देने वाली कंपनी के तौर पर, आपके पास क्लाइंट खातों के लिए सेवा की शर्तों को मैनेज करने का विकल्प होता है.

क्लाइंट खातों के लिए सेवा की शर्तें मैनेज करना

अगर आपके पास कोई ऐडवांस खाता है और आपने अलग-अलग कारोबारों के लिए क्लाइंट खाते बनाए हैं, तो:

  • ऐडवांस खाते के लिए शर्तें स्वीकार करना: अगर कोई ऐडवांस खाता, क्लाइंट खातों को खाते एग्रीगेट करने की सेवा देता है, तो ऐडवांस खाते के लिए स्वीकार की गई सेवा की शर्तें, उस सेवा का इस्तेमाल करने वाले सभी क्लाइंट खातों पर भी लागू होंगी.
  • दिखाना और सहमति लेना: भले ही, ऐडवांस खाते की सहमति में क्लाइंट खाते शामिल हों, लेकिन यह सबसे सही तरीका है (और कानूनी तौर पर ज़रूरी हो सकता है) कि हर क्लाइंट के कारोबार के असल मालिक को Google Merchant Center की सेवा की ज़रूरी शर्तें दिखाई जाएं. आपको उनकी साफ़ तौर पर सहमति लेनी होगी कि वे इन शर्तों को समझते हैं और इनसे सहमत हैं. भले ही, स्वीकार करने के लिए एपीआई कॉल, ऐडवांस खाते के लेवल पर किया गया हो.
  • क्लाइंट खाते की स्थिति देखना: किसी क्लाइंट खाते पर termsOfServiceAgreementStates.retrieveForApplication का इस्तेमाल करके, उसकी सेवा की शर्तों की स्थिति की पुष्टि करें. साथ ही, देखें कि वह ऐडवांस खाते के कानूनी समझौते के तहत आता है या नहीं. इसके अलावा, यह भी देखें कि क्या कोई कार्रवाई करने की ज़रूरत है.

अन्य खातों के लिए सेवा की शर्तें मैनेज करना

कारोबारियों को सेवा की शर्तें स्वीकार करने के लिए गाइड करें लेख में बताया गया है कि जब किसी कारोबार को उसका खाता बनाने या मैनेज करने में मदद की जाती है, तो उस कारोबार (खाते के मालिक) को सेवा की शर्तें खुद स्वीकार करनी होंगी . इसके लिए, आपको सेवा की शर्तें हासिल करके दिखानी होंगी. इसके बाद, जब उपयोगकर्ता आपके इंटरफ़ेस के ज़रिए साफ़ तौर पर सहमति दे दें, तब उनकी ओर से termsOfService.accept तरीके को कॉल करें.

पीछे जाएं
Manage homepage settings
आगे बढ़ें
Manage Merchant Center email preferences