हम 31 जुलाई, 2024 को Google Business Messages की सेवा बंद कर देंगे. यहां ज़्यादा जानकारी दी गई है.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

एजेंट या जगह की जानकारी की पुष्टि करें

Business Messages बनाने के बाद के लिए एजेंट एक ऐसा ब्रैंड जिसके लिए आप एजेंट की जानकारी को मैनेज और फ़ाइनल करते हैं, तो आप एजेंट और इनसे जुड़ी किसी भी जगह की जानकारी. आपको पहले एजेंट और जगह की जानकारी की पुष्टि करनी होगी वे कर सकते हैं लॉन्च करें.

एजेंट की पुष्टि करना

एजेंट की पुष्टि करने पर Business Messages, एजेंट की जानकारी की पुष्टि करता है उस ब्रैंड के प्रतिनिधि के तौर पर जिसकी जानकारी हो. ब्रैंड से संपर्क करने के बाद यह पुष्टि करती है कि आप एजेंट और एजेंट से ब्रैंड का प्रतिनिधित्व कर सकते हैं जानकारी सही है और एजेंट की पुष्टि हो गई है.

पुष्टि से पहले की चेकलिस्ट

अपने एजेंट की पुष्टि करने से पहले, किसी भी समस्या का पता लगाने के लिए यहां दी गई चेकलिस्ट का इस्तेमाल करें जो पुष्टि की प्रक्रिया के दौरान दिख सकती हैं.

एजेंट की जानकारी
एजेंट का नाम ज़रूरी है. एजेंट का नाम, जो लोगों को दिखता है. यहां जाएं: एजेंट बनाएं.
एजेंट का लोगो ज़रूरी है. एजेंट का लोगो, जैसा कि वह लोगों को दिखता है. यहां जाएं: एजेंट बनाएं.
मैसेज की उपलब्धता ज़रूरी है. लाइव एजेंट कितने दिन और समय पर उपलब्ध हैं मदद मिलती है. यहां जाएं: मैसेज की उपलब्धता सेट करना.
गैर-स्थानीय जानकारी इसके लिए ज़रूरी है नॉन-लोकल एंट्री पॉइंट. एजेंट से जुड़े डोमेन, फ़ोन और लॉन्च के लिए उपलब्ध इलाके. यहां जाएं: गैर-स्थानीय जानकारी सेट करना.
डिफ़ॉल्ट स्थान-भाषा ज़रूरी है. वह स्थान-भाषा जिसमें एजेंट आम तौर पर बातचीत करता है. यहां जाएं: स्थानीय भाषा के अनुसार और स्थान-भाषाएँ.
OAuth कॉन्फ़िगरेशन ज़रूरी नहीं. अन्य प्रॉडक्ट के साथ एजेंट के OAuth इंटिग्रेशन के बारे में जानकारी. यहां जाएं: OAuth से पुष्टि करें.
एंट्री पॉइंट की अनुमति है ज़रूरी है. सिर्फ़ इस बात का पता लगाना ज़रूरी है कि आपने कारोबार की मदद से एजेंट बनाया है या नहीं Communications API. यहां जाएं: एजेंट बनाएं.

अपने एजेंट की पुष्टि करने के बाद, सिर्फ़ इन आइटम को अपडेट किया जा सकता है:

conversationalSettings
customAgentId
defaultLocale
primaryAgentInteraction
additionalAgentInteractions
phone

अगर एजेंट की पुष्टि करने के बाद, आपको रीड ओनली फ़ील्ड अपडेट करने हैं, तो अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है हमसे संपर्क करें. (आपको पहले हस्ताक्षर करना होगा में Business Messages के Google खाते से साइन इन करें. खाता रजिस्टर करने के लिए, देखें Business Profile में रजिस्टर करें मैसेज.)

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

अपने एजेंट की पुष्टि करने से पहले, आपको कुछ जानकारी इकट्ठा करनी होगी:

एजेंट name

अगर आपको किसी एजेंट का नाम नहीं पता है, तो एक एजेंट के लिए सभी एजेंट की सूची देखें ब्रैंड के लिए चुनें.

ध्यान दें: एजेंट के नाम और आईडी, यूआरएल की मदद से कोड में बदले होने चाहिए. उदाहरण के लिए, अगर किसी एजेंट का नाम या आईडी में "/" शामिल है, बदलाव "/" है "%2F" में बदलें.
आपकी डेवलपमेंट मशीन पर, अपने GCP प्रोजेक्ट की सेवा खाता कुंजी का पाथ

पार्टनर का नाम (आपके संगठन का नाम)
पार्टनर का ईमेल पता (आपका ईमेल)
एजेंट जिस ब्रैंड का प्रतिनिधित्व करता है उसकी वेबसाइट, सार्वजनिक तौर पर उपलब्ध यूआरएल के तौर पर "https://" से शुरू होना चाहिए
इनके लिए संपर्क नाम और ईमेल पता (आम तौर पर, ब्रैंड की वेबसाइट के साथ डोमेन शेयर किया जाता है) वह ब्रैंड जिसका प्रतिनिधित्व एजेंट आपके कारोबारी संबंध की पुष्टि कर सकता है साथ ही, ब्रैंड को पेश करने का अधिकार है.

एजेंट की पुष्टि करें

किसी एजेंट की पुष्टि का अनुरोध करने पर, Business Messages, ब्रैंड को ईमेल भेजता है इस नंबर पर कॉल करें.

जब ब्रैंड संपर्क आपके एजेंट की जानकारी और Business Messages की पुष्टि करता है की पुष्टि करता है और आपको एक ईमेल मिलता है.

एजेंट की पुष्टि करने के लिए, नीचे दिया गया कमांड चलाएं. वैरिएबल को वैल्यू से बदलें ज़रूरी शर्तों में बताया गया है.

cURL


# This code requests a verification of a Business Messages agent.
# Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/verify?method=api#verify_an_agent

# Replace the __BRAND_ID__ and __AGENT_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X POST \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__:requestVerification" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "agentVerificationContact": {
    "partnerName": "Partner name",
    "partnerEmailAddress": "partner@email.com",
    "brandContactName": "Brand contact name",
    "brandContactEmailAddress": "brand-contact@email.com",
    "brandWebsiteUrl": "https://www.your-company-website.com"
  }
}'create-agent-verification.sh

Node.js


/**
 * This code snippet requests an agent verification.
 * Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/verify?method=api#verify_an_agent
 *
 * This code is based on the https://github.com/google-business-communications/nodejs-businesscommunications Node.js
 * Business Communications client library.
 */

/**
 * Edit the values below:
 */
const BRAND_ID = 'EDIT_HERE';
const AGENT_ID = 'EDIT_HERE';
const PATH_TO_SERVICE_ACCOUNT_KEY = './service_account_key.json';

const businesscommunications = require('businesscommunications');
const {google} = require('googleapis');

// Initialize the Business Communications API
const bcApi = new businesscommunications.businesscommunications_v1.Businesscommunications({});

// Set the scope that we need for the Business Communications API
const scopes = [
  'https://www.googleapis.com/auth/businesscommunications',
];

// Set the private key to the service account file
const privatekey = require(PATH_TO_SERVICE_ACCOUNT_KEY);

async function main() {
  const authClient = await initCredentials();

  const agentName = 'brands/' + BRAND_ID + '/agents/' + AGENT_ID;

  if (authClient) {
    const agentVerificationContact = {
      agentVerificationContact: {
        partnerName: 'Partner name',
        partnerEmailAddress: 'partner@email.com',
        brandContactName: 'Brand contact name',
        brandContactEmailAddress: 'brand-contact@email.com',
        brandWebsiteUrl: 'https://www.your-company-website.com',
      },
    };

    // Setup the parameters for the API call
    const apiParams = {
      auth: authClient,
      name: agentName,
      resource: agentVerificationContact,
    };

    bcApi.brands.agents.requestVerification(apiParams, {}, (err, response) => {
      if (err !== undefined && err !== null) {
        console.dir(err);
      } else {
        // Agent found
        console.log(response.data);
      }
    });
  }
  else {
    console.log('Authentication failure.');
  }
}

/**
 * Initializes the Google credentials for calling the
 * Business Messages API.
 */
 async function initCredentials() {
  // Configure a JWT auth client
  const authClient = new google.auth.JWT(
    privatekey.client_email,
    null,
    privatekey.private_key,
    scopes,
  );

  return new Promise(function(resolve, reject) {
    // Authenticate request
    authClient.authorize(function(err, tokens) {
      if (err) {
        reject(false);
      } else {
        resolve(authClient);
      }
    });
  });
}

main();create-agent-verification.js

Java

import com.google.api.client.googleapis.auth.oauth2.GoogleCredential;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.HttpTransport;
import com.google.api.client.json.jackson2.JacksonFactory;
import com.google.api.services.businesscommunications.v1.BusinessCommunications;
import com.google.api.services.businesscommunications.v1.model.Agent;
import java.io.FileInputStream;
import java.util.Arrays;

class Main {
  /**
   * Initializes credentials used by the Business Communications API.
   */
  private static BusinessCommunications.Builder getBusinessCommunicationsBuilder() {
    BusinessCommunications.Builder builder = null;
    try {
      GoogleCredential credential = GoogleCredential
            .fromStream(new FileInputStream("PATH_TO_SERVICE_ACCOUNT_KEY"));

      credential = credential.createScoped(Arrays.asList(
          "https://www.googleapis.com/auth/businesscommunications"));

      credential.refreshToken();

      HttpTransport httpTransport = GoogleNetHttpTransport.newTrustedTransport();
      JacksonFactory jsonFactory = JacksonFactory.getDefaultInstance();

      // Create instance of the Business Communications API
      builder = new BusinessCommunications
          .Builder(httpTransport, jsonFactory, null)
          .setApplicationName(credential.getServiceAccountProjectId());

      // Set the API credentials and endpoint
      builder.setHttpRequestInitializer(credential);
    } catch (Exception e) {
      e.printStackTrace();
    }

    return builder;
  }

  public static void main(String args[]) {
    try {
      // Create client library reference
      BusinessCommunications.Builder builder = getBusinessCommunicationsBuilder();

      String agentName = "brands/BRAND_ID/agents/AGENT_ID";

      BusinessCommunications.Brands.Agents.RequestVerification request
          = builder.build().brands().agents().requestVerification(agentName,
          new RequestAgentVerificationRequest().setAgentVerificationContact(
              new AgentVerificationContact()
                  .setPartnerName("PARTNER_NAME")
                  .setPartnerEmailAddress("PARTNER_EMAIL")
                  .setBrandContactName("BRAND_CONTACT_NAME")
                  .setBrandContactEmailAddress("BRAND_CONTACT_EMAIL")
                  .setBrandWebsiteUrl("BRAND_WEBSITE_URL")));

      System.out.println(request.execute().toPrettyString());
    } catch (Exception e) {
      e.printStackTrace();
    }
  }
}

यह कोड इस पर आधारित है Java बिज़नेस बातचीत के लिए क्लाइंट लाइब्रेरी.

Python


"""This code requests a verification of a Business Messages agent.

Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/verify?method=api#verify_an_agent

This code is based on the https://github.com/google-business-communications/python-businessmessages
Python Business Messages client library.
"""

from oauth2client.service_account import ServiceAccountCredentials
from businesscommunications.businesscommunications_v1_client import BusinesscommunicationsV1
from businesscommunications.businesscommunications_v1_messages import (
    BusinesscommunicationsBrandsAgentsRequestVerificationRequest,
    RequestAgentVerificationRequest,
    AgentVerificationContact
)

# Edit the values below:
BRAND_ID = 'EDIT_HERE'
AGENT_ID = 'EDIT_HERE'
SCOPES = ['https://www.googleapis.com/auth/businesscommunications']
SERVICE_ACCOUNT_FILE = './service_account_key.json'

credentials = ServiceAccountCredentials.from_json_keyfile_name(
    SERVICE_ACCOUNT_FILE, scopes=SCOPES)

client = BusinesscommunicationsV1(credentials=credentials)

agents_service = BusinesscommunicationsV1.BrandsAgentsService(client)

agent_name = 'brands/' + BRAND_ID + '/agents/' + AGENT_ID

verification_request = agents_service.RequestVerification(BusinesscommunicationsBrandsAgentsRequestVerificationRequest(
        name=agent_name,
        requestAgentVerificationRequest=RequestAgentVerificationRequest(
            agentVerificationContact=AgentVerificationContact(
                partnerName='Partner name',
                partnerEmailAddress='partner@email.com',
                brandContactName='Brand contact name',
                brandContactEmailAddress='brand-contact@email.com',
                brandWebsiteUrl='https://www.your-company-website.com'
           ))
    ))

print(verification_request)create-agent-verification.py

फ़ॉर्मैटिंग और वैल्यू के विकल्पों के लिए, यह देखें brands.agents.requestVerification.

एजेंट की पुष्टि की स्थिति देखें

एजेंट की पुष्टि का अनुरोध करने के बाद, अपने एजेंट की पुष्टि की स्थिति.

एजेंट की पुष्टि की स्थिति पाने के लिए, नीचे दिया गया कमांड चलाएं. बदलें ऐसे वैरिएबल जिनके मान यहां दिए गए हैं ज़रूरी शर्तें.

cURL


# This code gets the agent verification state.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.locations/getVerification

# Replace the __BRAND_ID__ and __AGENT_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X GET \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__/verification" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)"get-agent-verification-state.sh

Node.js


/**
 * This code snippet gets an agent verification state.
 * Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.locations/getVerification
 *
 * This code is based on the https://github.com/google-business-communications/nodejs-businesscommunications Node.js
 * Business Communications client library.
 */

/**
 * Edit the values below:
 */
const BRAND_ID = 'EDIT_HERE';
const AGENT_ID = 'EDIT_HERE';
const PATH_TO_SERVICE_ACCOUNT_KEY = './service_account_key.json';

const businesscommunications = require('businesscommunications');
const {google} = require('googleapis');

// Initialize the Business Communications API
const bcApi = new businesscommunications.businesscommunications_v1.Businesscommunications({});

// Set the scope that we need for the Business Communications API
const scopes = [
  'https://www.googleapis.com/auth/businesscommunications',
];

// Set the private key to the service account file
const privatekey = require(PATH_TO_SERVICE_ACCOUNT_KEY);

async function main() {
  const authClient = await initCredentials();

  const agentName = 'brands/' + BRAND_ID + '/agents/' + AGENT_ID;

  if (authClient) {
    // Setup the parameters for the API call
    const apiParams = {
      auth: authClient,
      name: agentName + '/verification',
    };

    bcApi.brands.agents.getVerification(apiParams, {}, (err, response) => {
      if (err !== undefined && err !== null) {
        console.dir(err);
      } else {
        // Agent found
        console.log(response.data);
      }
    });
  }
  else {
    console.log('Authentication failure.');
  }
}

/**
 * Initializes the Google credentials for calling the
 * Business Messages API.
 */
 async function initCredentials() {
  // Configure a JWT auth client
  const authClient = new google.auth.JWT(
    privatekey.client_email,
    null,
    privatekey.private_key,
    scopes,
  );

  return new Promise(function(resolve, reject) {
    // Authenticate request
    authClient.authorize(function(err, tokens) {
      if (err) {
        reject(false);
      } else {
        resolve(authClient);
      }
    });
  });
}

main();get-agent-verification-state.js

Java

import com.google.api.client.googleapis.auth.oauth2.GoogleCredential;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.HttpTransport;
import com.google.api.client.json.jackson2.JacksonFactory;
import com.google.api.services.businesscommunications.v1.BusinessCommunications;
import com.google.api.services.businesscommunications.v1.model.Agent;
import java.io.FileInputStream;
import java.util.Arrays;

class Main {
  /**
   * Initializes credentials used by the Business Communications API.
   */
  private static BusinessCommunications.Builder getBusinessCommunicationsBuilder() {
    BusinessCommunications.Builder builder = null;
    try {
      GoogleCredential credential = GoogleCredential
            .fromStream(new FileInputStream("PATH_TO_SERVICE_ACCOUNT_KEY"));

      credential = credential.createScoped(Arrays.asList(
          "https://www.googleapis.com/auth/businesscommunications"));

      credential.refreshToken();

      HttpTransport httpTransport = GoogleNetHttpTransport.newTrustedTransport();
      JacksonFactory jsonFactory = JacksonFactory.getDefaultInstance();

      // Create instance of the Business Communications API
      builder = new BusinessCommunications
          .Builder(httpTransport, jsonFactory, null)
          .setApplicationName(credential.getServiceAccountProjectId());

      // Set the API credentials and endpoint
      builder.setHttpRequestInitializer(credential);
    } catch (Exception e) {
      e.printStackTrace();
    }

    return builder;
  }

  public static void main(String args[]) {
    try {
      // Create client library reference
      BusinessCommunications.Builder builder = getBusinessCommunicationsBuilder();

      String agentName = "brands/BRAND_ID/agents/AGENT_ID/verification";

      BusinessCommunications.Brands.Agents.GetVerification request
          = builder.build().brands().agents().getVerification(agentName);

      System.out.println(request.execute().toPrettyString());
    } catch (Exception e) {
      e.printStackTrace();
    }
  }
}

यह कोड इस पर आधारित है Java बिज़नेस बातचीत के लिए क्लाइंट लाइब्रेरी.

Python


"""This code gets the agent verification state.

Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.locations/getVerification

This code is based on the https://github.com/google-business-communications/python-businessmessages
Python Business Messages client library.
"""

from oauth2client.service_account import ServiceAccountCredentials
from businesscommunications.businesscommunications_v1_client import BusinesscommunicationsV1
from businesscommunications.businesscommunications_v1_messages import (
    BusinesscommunicationsBrandsAgentsGetVerificationRequest,
)

# Edit the values below:
BRAND_ID = 'EDIT_HERE'
AGENT_ID = 'EDIT_HERE'
SCOPES = ['https://www.googleapis.com/auth/businesscommunications']
SERVICE_ACCOUNT_FILE = './service_account_key.json'

credentials = ServiceAccountCredentials.from_json_keyfile_name(
    SERVICE_ACCOUNT_FILE, scopes=SCOPES)

client = BusinesscommunicationsV1(credentials=credentials)

agents_service = BusinesscommunicationsV1.BrandsAgentsService(client)

agent_name = 'brands/' + BRAND_ID + '/agents/' + AGENT_ID + '/verification'

verification_state = agents_service.GetVerification(BusinesscommunicationsBrandsAgentsGetVerificationRequest(
        name=agent_name
    ))

print(verification_state)get-agent-verification-state.py

फ़ॉर्मैटिंग और वैल्यू के विकल्पों के लिए, यह देखें brands.agents.getVerification.

एजेंट की पुष्टि करने का अनुरोध रद्द करना

अगर आपको पता चलता है कि एजेंट की जानकारी गलत है या वह जानकारी गलत है पुष्टि के लिए तैयार नहीं है, तो पुष्टि के उन अनुरोधों को रद्द किया जा सकता है जिन्हें मंज़ूरी मिलना बाकी है. अगर आपने आपने अनुरोध रद्द कर दिया है, Business Messages आपके ब्रैंड संपर्क को इसकी सूचना देता है पुष्टि की प्रक्रिया फिर से शुरू करने के लिए, पुष्टि करने का नया अनुरोध करना होगा.

एजेंट की पुष्टि करने के अनुरोध को रद्द करने के लिए, नीचे दिया गया कमांड चलाएं. बदलें ऐसे वैरिएबल जिनके मान यहां दिए गए हैं ज़रूरी शर्तें.

cURL


# This code updates the verification state of an agent.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.agents/updateVerification

# Replace the __BRAND_ID__ and __AGENT_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__/verification" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "verificationState": "VERIFICATION_STATE_UNVERIFIED"
}'update-agent-verification-state.sh

Node.js


/**
 * This code snippet updates the state of an agent verification.
 * Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.agents/updateVerification
 *
 * This code is based on the https://github.com/google-business-communications/nodejs-businesscommunications Node.js
 * Business Communications client library.
 */

/**
 * Edit the values below:
 */
const BRAND_ID = 'EDIT_HERE';
const AGENT_ID = 'EDIT_HERE';
const PATH_TO_SERVICE_ACCOUNT_KEY = './service_account_key.json';

const businesscommunications = require('businesscommunications');
const {google} = require('googleapis');

// Initialize the Business Communications API
const bcApi = new businesscommunications.businesscommunications_v1.Businesscommunications({});

// Set the scope that we need for the Business Communications API
const scopes = [
  'https://www.googleapis.com/auth/businesscommunications',
];

// Set the private key to the service account file
const privatekey = require(PATH_TO_SERVICE_ACCOUNT_KEY);

async function main() {
  const authClient = await initCredentials();

  const agentName = 'brands/' + BRAND_ID + '/agents/' + AGENT_ID;

  if (authClient) {
    // Setup the parameters for the API call
    const apiParams = {
      auth: authClient,
      name: agentName + '/verification',
      updateMask: 'verificationState',
      resource: {
        name: agentName,
        verificationState: 'VERIFICATION_STATE_UNVERIFIED',
      }
    };

    bcApi.brands.agents.updateVerification(apiParams, {}, (err, response) => {
      if (err !== undefined && err !== null) {
        console.dir(err);
      } else {
        // Agent found
        console.log(response.data);
      }
    });
  }
  else {
    console.log('Authentication failure.');
  }
}

/**
 * Initializes the Google credentials for calling the
 * Business Messages API.
 */
 async function initCredentials() {
  // Configure a JWT auth client
  const authClient = new google.auth.JWT(
    privatekey.client_email,
    null,
    privatekey.private_key,
    scopes,
  );

  return new Promise(function(resolve, reject) {
    // Authenticate request
    authClient.authorize(function(err, tokens) {
      if (err) {
        reject(false);
      } else {
        resolve(authClient);
      }
    });
  });
}

main();update-agent-verification-state.js

Java

import com.google.api.client.googleapis.auth.oauth2.GoogleCredential;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.HttpTransport;
import com.google.api.client.json.jackson2.JacksonFactory;
import com.google.api.services.businesscommunications.v1.BusinessCommunications;
import com.google.api.services.businesscommunications.v1.model.Agent;
import java.io.FileInputStream;
import java.util.Arrays;

class Main {
  /**
   * Initializes credentials used by the Business Communications API.
   */
  private static BusinessCommunications.Builder getBusinessCommunicationsBuilder() {
    BusinessCommunications.Builder builder = null;
    try {
      GoogleCredential credential = GoogleCredential
            .fromStream(new FileInputStream("PATH_TO_SERVICE_ACCOUNT_KEY"));

      credential = credential.createScoped(Arrays.asList(
          "https://www.googleapis.com/auth/businesscommunications"));

      credential.refreshToken();

      HttpTransport httpTransport = GoogleNetHttpTransport.newTrustedTransport();
      JacksonFactory jsonFactory = JacksonFactory.getDefaultInstance();

      // Create instance of the Business Communications API
      builder = new BusinessCommunications
          .Builder(httpTransport, jsonFactory, null)
          .setApplicationName(credential.getServiceAccountProjectId());

      // Set the API credentials and endpoint
      builder.setHttpRequestInitializer(credential);
    } catch (Exception e) {
      e.printStackTrace();
    }

    return builder;
  }

  public static void main(String args[]) {
    try {
      // Create client library reference
      BusinessCommunications.Builder builder = getBusinessCommunicationsBuilder();

      String agentName = "brands/BRAND_ID/agents/AGENT_ID/verification";

      BusinessCommunications.Brands.Agents.UpdateVerification request
          = builder.build().brands().agents().updateVerification(agentName,
              new AgentVerification().setVerificationState("VERIFICATION_STATE_UNVERIFIED"));

      System.out.println(request.execute().toPrettyString());
    } catch (Exception e) {
      e.printStackTrace();
    }
  }
}

यह कोड इस पर आधारित है Java बिज़नेस बातचीत के लिए क्लाइंट लाइब्रेरी.

Python


"""This code updates the verification state of an agent.

Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.agents/updateVerification

This code is based on the https://github.com/google-business-communications/python-businessmessages
Python Business Messages client library.
"""

from oauth2client.service_account import ServiceAccountCredentials
from businesscommunications.businesscommunications_v1_client import BusinesscommunicationsV1
from businesscommunications.businesscommunications_v1_messages import (
    AgentVerification,
    BusinesscommunicationsBrandsAgentsUpdateVerificationRequest,
)

# Edit the values below:
BRAND_ID = 'EDIT_HERE'
AGENT_ID = 'EDIT_HERE'
SCOPES = ['https://www.googleapis.com/auth/businesscommunications']
SERVICE_ACCOUNT_FILE = './service_account_key.json'

credentials = ServiceAccountCredentials.from_json_keyfile_name(
    SERVICE_ACCOUNT_FILE, scopes=SCOPES)

client = BusinesscommunicationsV1(credentials=credentials)

agents_service = BusinesscommunicationsV1.BrandsAgentsService(client)

agent_name = 'brands/' + BRAND_ID + '/agents/' + AGENT_ID + '/verification'

update_request = agents_service.UpdateVerification(
        BusinesscommunicationsBrandsAgentsUpdateVerificationRequest(
            name=agent_name,
            updateMask='verificationState',
            agentVerification=AgentVerification(verificationState=AgentVerification.VerificationStateValueValuesEnum.VERIFICATION_STATE_UNVERIFIED)
        )
    )

print(update_request)update-agent-verification-state.py

फ़ॉर्मैटिंग और वैल्यू के विकल्पों के लिए, यह देखें brands.agents.updateVerification.

लोकेशन की पुष्टि

एजेंट की पुष्टि करने के बाद, उससे जुड़ी जगहों की जानकारी की पुष्टि की जा सकती है. जगह की जानकारी की पुष्टि होने और उससे जुड़े एजेंट के लॉन्च हो जाने के बाद, जगह की जानकारी की सुविधा को लॉन्च किया जा सकता है एजेंट के साथ इस्तेमाल करने के लिए जगह.

अगर ब्रैंड किसी चेन का हिस्सा है, तो आपको उस चेन के लिए सभी जगहों को जोड़ना होगा, जहां आपके पास मैसेज सेवा चालू करने की अनुमति है. आपने जो जगहें जोड़ी हैं उनकी पुष्टि करने के लिए, सिर्फ़ एक जगह की पुष्टि का अनुरोध करें. उस जगह की पुष्टि करने के बाद, आपकी जोड़ी गई अन्य जगहों की पुष्टि अपने-आप हो जाएगी.

पुष्टि के बाद, अगर आप और जगहें जोड़ते हैं, तो आपको अनुरोध करना होगा जगह की जानकारी की पुष्टि फिर से करें. अगर किसी जगह की जानकारी की पुष्टि अपने-आप नहीं होती है, तो प्लीज़ हमसे संपर्क करें कारोबार और जगहों की जानकारी.

पुष्टि से पहले की चेकलिस्ट

अपनी जगह की जानकारी की पुष्टि करने से पहले, यहां दी गई चेकलिस्ट का इस्तेमाल करके, किसी भी समस्या की जांच करें जो पुष्टि की प्रक्रिया के दौरान दिख सकती हैं.

एजेंट की जानकारी
एजेंट की पुष्टि करना ज़रूरी है. इस बात की पुष्टि करना कि एजेंट की जानकारी सही है यह भी ज़रूरी है कि एजेंट, जुड़े हुए ब्रैंड का प्रतिनिधित्व कर सके. यहां जाएं: एजेंट और जगह की जानकारी की पुष्टि करें.

एजेंट की जानकारी

एजेंट की पुष्टि करना

ज़रूरी है. इस बात की पुष्टि करना कि एजेंट की जानकारी सही है यह भी ज़रूरी है कि एजेंट, जुड़े हुए ब्रैंड का प्रतिनिधित्व कर सके. यहां जाएं: एजेंट और जगह की जानकारी की पुष्टि करें.

जगह की जानकारी
जगह का आईडी ज़रूरी है. Google में किसी जगह के लिए यूनीक आइडेंटिफ़ायर जगहों का डेटाबेस और Google Maps पर मौजूद जानकारी. यहां जाएं: जगहों की जानकारी मैनेज करें.
एंट्री पॉइंट की अनुमति है ज़रूरी है. यह देखना सिर्फ़ ज़रूरी है कि एजेंट को बनाने के लिए इसका इस्तेमाल किया गया है या नहीं Business Communications एपीआई. यहां जाएं: जगहों की जानकारी मैनेज करें.

जगह की जानकारी

जगह का आईडी

ज़रूरी है. Google में किसी जगह के लिए यूनीक आइडेंटिफ़ायर जगहों का डेटाबेस और Google Maps पर मौजूद जानकारी. यहां जाएं: जगहों की जानकारी मैनेज करें.

एंट्री पॉइंट की अनुमति है

ज़रूरी है. यह देखना सिर्फ़ ज़रूरी है कि एजेंट को बनाने के लिए इसका इस्तेमाल किया गया है या नहीं Business Communications एपीआई. यहां जाएं: जगहों की जानकारी मैनेज करें.

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

अपने एजेंट की पुष्टि करने से पहले, आपको कुछ जानकारी इकट्ठा करनी होगी:

जगह name

अगर आपको एजेंट का नाम नहीं पता है, तो एजेंट के लिए सभी जगहों की सूची देखें ब्रैंड के लिए चुनें.
आपकी डेवलपमेंट मशीन पर, अपने GCP प्रोजेक्ट की सेवा खाता कुंजी का पाथ

जगह की पुष्टि करें

किसी जगह की पुष्टि का अनुरोध करने पर, Business Messages इस बात की पुष्टि करता है कि जगह की जानकारी, उस ब्रैंड से मैच करती हो जिसका इस्तेमाल करने वाला एजेंट काम करता है. आपको ईमेल करें.

किसी जगह की पुष्टि करने के बाद, उसमें कोई बदलाव नहीं किया जा सकता. अपडेट करने के लिए पुष्टि होने के बाद किसी जगह पर भेज दिया जाता है, अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है हमसे संपर्क करें. (आपको पहले हस्ताक्षर करना होगा में Business Messages के Google खाते से साइन इन करें. खाता रजिस्टर करने के लिए, देखें Business Profile में रजिस्टर करें मैसेज.)

किसी जगह की पुष्टि करने के लिए, नीचे दिया गया कमांड चलाएं. वैरिएबल को वैल्यू से बदलें ज़रूरी शर्तों में बताया गया है.

cURL


# This code requests a verification of a location.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.locations/requestVerification

# Replace the __BRAND_ID__ and __LOCATION_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X POST \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/locations/__LOCATION_ID__:requestVerification" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)"create-location-verification.sh

Node.js


/**
 * This code snippet requests a verification for a location.
 * Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.locations/requestVerification
 *
 * This code is based on the https://github.com/google-business-communications/nodejs-businesscommunications Node.js
 * Business Communications client library.
 */

/**
 * Edit the values below:
 */
const BRAND_ID = 'EDIT_HERE';
const LOCATION_ID = 'EDIT_HERE';
const PATH_TO_SERVICE_ACCOUNT_KEY = './service_account_key.json';

const businesscommunications = require('businesscommunications');
const {google} = require('googleapis');

// Initialize the Business Communications API
const bcApi = new businesscommunications.businesscommunications_v1.Businesscommunications({});

// Set the scope that we need for the Business Communications API
const scopes = [
  'https://www.googleapis.com/auth/businesscommunications',
];

// Set the private key to the service account file
const privatekey = require(PATH_TO_SERVICE_ACCOUNT_KEY);

async function main() {
  const authClient = await initCredentials();

  const locationName = 'brands/' + BRAND_ID + '/locations/' + LOCATION_ID;

  if (authClient) {
    // Setup the parameters for the API call
    const apiParams = {
      auth: authClient,
      name: locationName,
    };

    bcApi.brands.locations.requestVerification(apiParams, {}, (err, response) => {
      if (err !== undefined && err !== null) {
        console.dir(err);
      } else {
        // Agent found
        console.log(response.data);
      }
    });
  }
  else {
    console.log('Authentication failure.');
  }
}

/**
 * Initializes the Google credentials for calling the
 * Business Messages API.
 */
 async function initCredentials() {
  // Configure a JWT auth client
  const authClient = new google.auth.JWT(
    privatekey.client_email,
    null,
    privatekey.private_key,
    scopes,
  );

  return new Promise(function(resolve, reject) {
    // Authenticate request
    authClient.authorize(function(err, tokens) {
      if (err) {
        reject(false);
      } else {
        resolve(authClient);
      }
    });
  });
}

main();create-location-verification.js

Java

import com.google.api.client.googleapis.auth.oauth2.GoogleCredential;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.HttpTransport;
import com.google.api.client.json.jackson2.JacksonFactory;
import com.google.api.services.businesscommunications.v1.BusinessCommunications;
import com.google.api.services.businesscommunications.v1.model.Agent;
import java.io.FileInputStream;
import java.util.Arrays;

class Main {
  /**
   * Initializes credentials used by the Business Communications API.
   */
  private static BusinessCommunications.Builder getBusinessCommunicationsBuilder() {
    BusinessCommunications.Builder builder = null;
    try {
      GoogleCredential credential = GoogleCredential
            .fromStream(new FileInputStream("PATH_TO_SERVICE_ACCOUNT_KEY"));

      credential = credential.createScoped(Arrays.asList(
          "https://www.googleapis.com/auth/businesscommunications"));

      credential.refreshToken();

      HttpTransport httpTransport = GoogleNetHttpTransport.newTrustedTransport();
      JacksonFactory jsonFactory = JacksonFactory.getDefaultInstance();

      // Create instance of the Business Communications API
      builder = new BusinessCommunications
          .Builder(httpTransport, jsonFactory, null)
          .setApplicationName(credential.getServiceAccountProjectId());

      // Set the API credentials and endpoint
      builder.setHttpRequestInitializer(credential);
    } catch (Exception e) {
      e.printStackTrace();
    }

    return builder;
  }

  public static void main(String args[]) {
    try {
      // Create client library reference
      BusinessCommunications.Builder builder = getBusinessCommunicationsBuilder();

      String locationName = "brands/BRAND_ID/locations/LOCATION_ID/verification";

      BusinessCommunications.Brands.Locations.RequestVerification request
          = builder.build().brands().locations().requestVerification(locationName,
                new RequestLocationVerificationRequest());

      System.out.println(request.execute().toPrettyString());
    } catch (Exception e) {
      e.printStackTrace();
    }
  }
}

यह कोड इस पर आधारित है Java बिज़नेस बातचीत के लिए क्लाइंट लाइब्रेरी.

Python


"""This code requests a verification of a location.

Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.locations/requestVerification

This code is based on the https://github.com/google-business-communications/python-businessmessages
Python Business Messages client library.
"""

from oauth2client.service_account import ServiceAccountCredentials
from businesscommunications.businesscommunications_v1_client import BusinesscommunicationsV1
from businesscommunications.businesscommunications_v1_messages import (
    BusinesscommunicationsBrandsLocationsRequestVerificationRequest,
    RequestLocationVerificationRequest
)

# Edit the values below:
BRAND_ID = 'EDIT_HERE'
LOCATION_ID = 'EDIT_HERE'
SCOPES = ['https://www.googleapis.com/auth/businesscommunications']
SERVICE_ACCOUNT_FILE = './service_account_key.json'

credentials = ServiceAccountCredentials.from_json_keyfile_name(
    SERVICE_ACCOUNT_FILE, scopes=SCOPES)

client = BusinesscommunicationsV1(credentials=credentials)

locations_service = BusinesscommunicationsV1.BrandsLocationsService(client)

location_name = 'brands/' + BRAND_ID + '/locations/' + LOCATION_ID

verification_request = locations_service.RequestVerification(BusinesscommunicationsBrandsLocationsRequestVerificationRequest(
        name=location_name,
        requestLocationVerificationRequest=RequestLocationVerificationRequest()
    ))

print(verification_request)create-location-verification.py

फ़ॉर्मैटिंग और वैल्यू के विकल्पों के लिए, यह देखें brands.locations.requestVerification.

किसी जगह की पुष्टि की स्थिति पाना

जगह की जानकारी की पुष्टि का अनुरोध करने के बाद, जगह की जानकारी की जांच की जा सकती है पुष्टि की स्थिति.

किसी जगह की पुष्टि की स्थिति पाने के लिए, नीचे दिया गया कमांड चलाएं. बदलें ऐसे वैरिएबल जिनके मान यहां दिए गए हैं ज़रूरी शर्तें.

cURL


# This code gets the verification state of a location.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.locations/getVerification

# Replace the __BRAND_ID__ and __LOCATION_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X GET \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/locations/__LOCATION_ID__/verification" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)"get-location-verification-state.sh

Node.js


/**
 * This code snippet gets the verification state of a location.
 * Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.locations/getVerification?hl=en
 *
 * This code is based on the https://github.com/google-business-communications/nodejs-businesscommunications Node.js
 * Business Communications client library.
 */

/**
 * Edit the values below:
 */
const BRAND_ID = 'EDIT_HERE';
const LOCATION_ID = 'EDIT_HERE';
const PATH_TO_SERVICE_ACCOUNT_KEY = './service_account_key.json';

const businesscommunications = require('businesscommunications');
const {google} = require('googleapis');

// Initialize the Business Communications API
const bcApi = new businesscommunications.businesscommunications_v1.Businesscommunications({});

// Set the scope that we need for the Business Communications API
const scopes = [
  'https://www.googleapis.com/auth/businesscommunications',
];

// Set the private key to the service account file
const privatekey = require(PATH_TO_SERVICE_ACCOUNT_KEY);

async function main() {
  const authClient = await initCredentials();

  const locationName = 'brands/' + BRAND_ID + '/locations/' + LOCATION_ID;

  if (authClient) {
    // Setup the parameters for the API call
    const apiParams = {
      auth: authClient,
      name: locationName + '/verification',
    };

    bcApi.brands.locations.getVerification(apiParams, {}, (err, response) => {
      if (err !== undefined && err !== null) {
        console.dir(err);
      } else {
        // Agent found
        console.log(response.data);
      }
    });
  }
  else {
    console.log('Authentication failure.');
  }
}

/**
 * Initializes the Google credentials for calling the
 * Business Messages API.
 */
 async function initCredentials() {
  // Configure a JWT auth client
  const authClient = new google.auth.JWT(
    privatekey.client_email,
    null,
    privatekey.private_key,
    scopes,
  );

  return new Promise(function(resolve, reject) {
    // Authenticate request
    authClient.authorize(function(err, tokens) {
      if (err) {
        reject(false);
      } else {
        resolve(authClient);
      }
    });
  });
}

main();get-location-verification-state.js

Java

import com.google.api.client.googleapis.auth.oauth2.GoogleCredential;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.HttpTransport;
import com.google.api.client.json.jackson2.JacksonFactory;
import com.google.api.services.businesscommunications.v1.BusinessCommunications;
import com.google.api.services.businesscommunications.v1.model.Agent;
import java.io.FileInputStream;
import java.util.Arrays;

class Main {
  /**
   * Initializes credentials used by the Business Communications API.
   */
  private static BusinessCommunications.Builder getBusinessCommunicationsBuilder() {
    BusinessCommunications.Builder builder = null;
    try {
      GoogleCredential credential = GoogleCredential
            .fromStream(new FileInputStream("PATH_TO_SERVICE_ACCOUNT_KEY"));

      credential = credential.createScoped(Arrays.asList(
          "https://www.googleapis.com/auth/businesscommunications"));

      credential.refreshToken();

      HttpTransport httpTransport = GoogleNetHttpTransport.newTrustedTransport();
      JacksonFactory jsonFactory = JacksonFactory.getDefaultInstance();

      // Create instance of the Business Communications API
      builder = new BusinessCommunications
          .Builder(httpTransport, jsonFactory, null)
          .setApplicationName(credential.getServiceAccountProjectId());

      // Set the API credentials and endpoint
      builder.setHttpRequestInitializer(credential);
    } catch (Exception e) {
      e.printStackTrace();
    }

    return builder;
  }

  public static void main(String args[]) {
    try {
      // Create client library reference
      BusinessCommunications.Builder builder = getBusinessCommunicationsBuilder();

      String locationName = "brands/BRAND_ID/locations/LOCATION_ID/verification";

      BusinessCommunications.Brands.Locations.GetVerification request
          = builder.build().brands().locations().getVerification(locationName);

      System.out.println(request.execute().toPrettyString());
    } catch (Exception e) {
      e.printStackTrace();
    }
  }
}

यह कोड इस पर आधारित है Java बिज़नेस बातचीत के लिए क्लाइंट लाइब्रेरी.

Python


"""This code gets the verification state of a location.

Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.locations/getVerification

This code is based on the https://github.com/google-business-communications/python-businessmessages
Python Business Messages client library.
"""

from oauth2client.service_account import ServiceAccountCredentials
from businesscommunications.businesscommunications_v1_client import BusinesscommunicationsV1
from businesscommunications.businesscommunications_v1_messages import (
    BusinesscommunicationsBrandsLocationsGetVerificationRequest,
)

# Edit the values below:
BRAND_ID = 'EDIT_HERE'
LOCATION_ID = 'EDIT_HERE'
SCOPES = ['https://www.googleapis.com/auth/businesscommunications']
SERVICE_ACCOUNT_FILE = './service_account_key.json'

credentials = ServiceAccountCredentials.from_json_keyfile_name(
    SERVICE_ACCOUNT_FILE, scopes=SCOPES)

client = BusinesscommunicationsV1(credentials=credentials)

locations_service = BusinesscommunicationsV1.BrandsLocationsService(client)

location_name = 'brands/' + BRAND_ID + '/locations/' + LOCATION_ID + '/verification'

verification_state = locations_service.GetVerification(BusinesscommunicationsBrandsLocationsGetVerificationRequest(
        name=location_name
    ))

print(verification_state)get-location-verification-state.py

फ़ॉर्मैटिंग और वैल्यू के विकल्पों के लिए, यह देखें brands.locations.getVerification.

अगले चरण

अपने एजेंट और उससे जुड़ी जगहों की पुष्टि हो जाने के बाद, उन्हें लॉन्च कर दो ताकि वे लोगों से बातचीत कर सकें.