Rychlý start: Vyhledání informací o operátorech telefonního čísla pomocí Azure Communication Services
Důležité
Tato funkce služeb Azure Communication Services je aktuálně ve verzi Preview.
Rozhraní API a sady SDK verze Preview jsou poskytovány bez smlouvy o úrovni služeb. Doporučujeme je nepoužívat pro produkční úlohy. Některé funkce nemusí být podporované nebo můžou mít omezené možnosti.
Další informace najdete v dodatečných podmínkách použití pro verze Preview Microsoft Azure.
Začněte s klientskou knihovnou Telefon Numbers pro JavaScript a vyhledejte informace o operátorech pro telefonní čísla, která se dají použít k určení, jestli a jak s tímto telefonním číslem komunikovat. Podle těchto kroků nainstalujte balíček a vyhledejte informace o telefonním čísle operátora.
Poznámka:
Najděte kód pro tento rychlý start na GitHubu.
Požadavky
- Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
- Node.js verze ACTIVE LTS (dlouhodobá podpora) a údržba LTS (doporučuje se verze 8.11.1 a 10.14.1).
- Aktivní prostředek služby Communication Services a připojovací řetězec. Vytvořte prostředek komunikační služby.
Kontrola požadovaných součástí
V terminálu nebo příkazovém okně spusťte node --version příkaz a zkontrolujte, jestli je nainstalovaná Node.js.
Nastavení
Pokud chcete nastavit prostředí pro odesílání vyhledávacích dotazů, proveďte kroky v následujících částech.
Vytvoření nové aplikace Node.js
V terminálu nebo příkazovém okně vytvořte pro aplikaci nový adresář a přejděte na něj.
mkdir number-lookup-quickstart && cd number-lookup-quickstart
Spuštěním příkazu npm init -y vytvořte soubor package.json s výchozím nastavením.
npm init -y
Vytvořte soubor s názvem number-lookup-quickstart.js v kořenovém adresáři, který jste vytvořili. Přidejte do něj následující fragment kódu:
async function main() {
// quickstart code will go here
}
main();
Nainstalujte balíček .
Pomocí příkazu nainstalujte klientskou knihovnu npm install Azure Communication Services Telefon Numbers pro JavaScript.
npm install @azure/communication-phone-numbers@1.3.0-beta.4 --save
Tato --save možnost přidá knihovnu jako závislost do souboru package.json .
Příklady kódu
Ověření klienta
Naimportujte Telefon NumbersClient z klientské knihovny a vytvořte instanci pomocí svého připojovací řetězec, který můžete získat z prostředku Azure Communication Services na webu Azure Portal. Použití proměnné prostředí se doporučuje vyhnout vložení připojovací řetězec do prostého COMMUNICATION_SERVICES_CONNECTION_STRING textu v kódu. Zjistěte, jak spravovat připojovací řetězec vašeho prostředku.
Na začátek number-lookup-quickstart.js přidejte následující kód:
const { PhoneNumbersClient } = require('@azure/communication-phone-numbers');
// This code retrieves your connection string from an environment variable
const connectionString = process.env['COMMUNICATION_SERVICES_CONNECTION_STRING'];
// Instantiate the phone numbers client
const phoneNumbersClient = new PhoneNumbersClient(connectionString);
Vyhledání formátování telefonního čísla
Pokud chcete vyhledat informace o operátorovi telefonního čísla, zavolejte searchOperatorInformation z telefonu PhoneNumbersClient.
let formattingResults = await phoneNumbersClient.searchOperatorInformation([ "<target-phone-number>" ]);
Nahraďte <target-phone-number> telefonním číslem, které hledáte, obvykle číslo, na které chcete poslat zprávu.
Upozorňující
Zadejte telefonní čísla v mezinárodním standardním formátu E.164, například +14255550123.
Vyhledání informací o operátoru čísla
Pokud chcete vyhledat informace o operátorovi telefonního čísla, zavolejte searchOperatorInformation z PhoneNumbersClienttelefonu a předejte includeAdditionalOperatorDetailstrue možnost.
let searchResults = await phoneNumbersClient.searchOperatorInformation([ "<target-phone-number>" ], { "includeAdditionalOperatorDetails": true });
Upozorňující
Použití této funkce bude účtovat poplatky za váš účet.
Použití informací o operátoru
Teď můžete použít informace o operátoru. Pro účely tohoto rychlého startu můžeme do konzoly vytisknout některé podrobnosti.
Nejprve můžeme vytisknout podrobnosti o formátu čísla.
let formatInfo = formattingResults.values[0];
console.log(formatInfo.phoneNumber + " is formatted " + formatInfo.internationalFormat + " internationally, and " + formatInfo.nationalFormat + " nationally");
V dalším kroku můžeme vytisknout podrobnosti o telefonním čísle a operátorovi.
let operatorInfo = searchResults.values[0];
console.log(operatorInfo.phoneNumber + " is a " + (operatorInfo.numberType ? operatorInfo.numberType : "unknown") + " number, operated in "
+ operatorInfo.isoCountryCode + " by " + (operatorInfo.operatorDetails.name ? operatorInfo.operatorDetails.name : "an unknown operator"));
Informace o operátoru můžete použít také k určení, zda se má odeslat SMS. Další informace o odesílání sms najdete v rychlém startu sms.
Spuštění kódu
Spusťte aplikaci z terminálu nebo příkazového node okna pomocí příkazu.
node number-lookup-quickstart.js
Ukázkový kód
Ukázkovou aplikaci si můžete stáhnout z GitHubu).
Začněte s klientskou knihovnou Telefon Numbers pro jazyk C# a vyhledejte informace o operátorech telefonních čísel, která se dají použít k určení, jestli a jak s tímto telefonním číslem komunikovat. Podle těchto kroků nainstalujte balíček a vyhledejte informace o telefonním čísle operátora.
Poznámka:
Najděte kód pro tento rychlý start na GitHubu.
Požadavky
- Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
- Nejnovější verze klientské knihovny .NET Core pro váš operační systém.
- Aktivní prostředek služby Communication Services a připojovací řetězec. Vytvořte prostředek komunikační služby.
Kontrola požadovaných součástí
V terminálu nebo příkazovém okně spusťte dotnet příkaz a zkontrolujte, jestli je nainstalovaná sada .NET SDK.
Nastavení
Pokud chcete nastavit prostředí pro odesílání vyhledávacích dotazů, proveďte kroky v následujících částech.
Vytvoření nové aplikace jazyka C#
V terminálu nebo příkazovém okně spusťte dotnet new příkaz a vytvořte novou konzolovou aplikaci s názvem NumberLookupQuickstart. Tento příkaz vytvoří jednoduchý projekt "Hello World" C# s jedním zdrojovým souborem Program.cs.
dotnet new console -o NumberLookupQuickstart
Změňte adresář na nově vytvořenou složku aplikace a pomocí dotnet build příkazu zkompilujte aplikaci.
cd NumberLookupQuickstart
dotnet build
Připojení k kanálu balíčků pro vývoj
Verze Public Preview sady SDK se publikuje do kanálu vývojového balíčku. Kanál pro vývoj můžete přidat pomocí rozhraní příkazového řádku NuGet, které ho přidá do souboru NuGet.Config.
nuget sources add -Name "Azure SDK for .NET Dev Feed" -Source "https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-net/nuget/v3/index.json"
Podrobnější informace a další možnosti připojení k vývojovému kanálu najdete v průvodci přispívání.
Nainstalujte balíček .
V adresáři aplikace nainstalujte klientskou knihovnu azure Communication Services Telefon Numbers pro balíček .NET pomocí následujícího příkazu.
dotnet add package Azure.Communication.PhoneNumbers --version 1.3.0-beta.5
Přidejte direktivu using na začátek Program.cs , která bude zahrnovat Azure.Communication obor názvů.
using System;
using System.Threading.Tasks;
using Azure.Communication.PhoneNumbers;
Aktualizujte Main podpis funkce tak, aby byl asynchronní.
internal class Program
{
static async Task Main(string[] args)
{
...
}
}
Příklady kódu
Ověření klienta
Telefon počet klientů je možné ověřit pomocí připojovací řetězec získaného z prostředku Azure Communication Services na webu Azure Portal. Použití proměnné prostředí se doporučuje vyhnout vložení připojovací řetězec do prostého COMMUNICATION_SERVICES_CONNECTION_STRING textu v kódu. Zjistěte, jak spravovat připojovací řetězec vašeho prostředku.
// This code retrieves your connection string from an environment variable.
string? connectionString = Environment.GetEnvironmentVariable("COMMUNICATION_SERVICES_CONNECTION_STRING");
PhoneNumbersClient client = new PhoneNumbersClient(connectionString, new PhoneNumbersClientOptions(PhoneNumbersClientOptions.ServiceVersion.V2024_03_01_Preview));
Telefon Počet klientů se také můžou ověřovat pomocí ověřování Microsoft Entra. Pomocí této možnosti je AZURE_CLIENT_SECRETAZURE_CLIENT_IDpotřeba nastavit proměnné prostředí a AZURE_TENANT_ID ověřování.
// Get an endpoint to our Azure Communication Services resource.
Uri endpoint = new Uri("<endpoint_url>");
TokenCredential tokenCredential = new DefaultAzureCredential();
client = new PhoneNumbersClient(endpoint, tokenCredential);
Vyhledání formátování telefonního čísla
Pokud chcete vyhledat národní a mezinárodní formátování čísla, zavolejte SearchOperatorInformationAsync z čísla PhoneNumbersClient.
OperatorInformationResult formattingResult = await client.SearchOperatorInformationAsync(new[] { "<target-phone-number>" });
Nahraďte <target-phone-number> telefonním číslem, které hledáte, obvykle číslo, na které chcete poslat zprávu.
Upozorňující
Zadejte telefonní čísla v mezinárodním standardním formátu E.164, například +14255550123.
Vyhledání informací o operátoru čísla
Pokud chcete vyhledat informace o operátorovi telefonního čísla, zavolejte SearchOperatorInformationAsync z PhoneNumbersClienttelefonu a předejte IncludeAdditionalOperatorDetailstrue možnost.
OperatorInformationResult searchResult = await client.SearchOperatorInformationAsync(new[] { "<target-phone-number>" }, new OperatorInformationOptions() { IncludeAdditionalOperatorDetails = true });
Upozorňující
Použití této funkce bude účtovat poplatky za váš účet.
Použití informací o operátoru
Teď můžete použít informace o operátoru. Pro účely tohoto rychlého startu můžeme do konzoly vytisknout některé podrobnosti.
Nejprve můžeme vytisknout podrobnosti o formátu čísla.
OperatorInformation formattingInfo = formattingResult.Values[0];
Console.WriteLine($"{formattingInfo.PhoneNumber} is formatted {formattingInfo.InternationalFormat} internationally, and {formattingInfo.NationalFormat} nationally");
V dalším kroku můžeme vytisknout podrobnosti o telefonním čísle a operátorovi.
OperatorInformation operatorInformation = searchResult.Values[0];
Console.WriteLine($"{operatorInformation.PhoneNumber} is a {operatorInformation.NumberType ?? "unknown"} number, operated in {operatorInformation.IsoCountryCode} by {operatorInformation.OperatorDetails.Name ?? "an unknown operator"}");
Informace o operátoru můžete použít také k určení, zda se má odeslat SMS. Další informace o odesílání sms najdete v rychlém startu sms.
Spuštění kódu
Spusťte aplikaci z terminálu nebo příkazového dotnet run okna pomocí příkazu.
dotnet run --interactive
Ukázkový kód
Ukázkovou aplikaci si můžete stáhnout z GitHubu.
Začněte s klientskou knihovnou Telefon Numbers pro Javu a vyhledejte informace o operátorech telefonních čísel, která se dají použít k určení, jestli a jak s tímto telefonním číslem komunikovat. Podle těchto kroků nainstalujte balíček a vyhledejte informace o telefonním čísle operátora.
Poznámka:
Najděte kód pro tento rychlý start na GitHubu.
Požadavky
- Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
- Java Development Kit (JDK) verze 8 nebo novější.
- Apache Maven
- Aktivní prostředek služby Communication Services a připojovací řetězec. Vytvořte prostředek komunikační služby.
Kontrola požadovaných součástí
V terminálu nebo příkazovém okně spusťte mvn -v příkaz a zkontrolujte, jestli je Maven nainstalovaný.
Nastavení
Pokud chcete nastavit prostředí pro odesílání vyhledávacích dotazů, proveďte kroky v následujících částech.
Vytvoření nové aplikace v Javě
V terminálu nebo příkazovém okně přejděte do adresáře, do kterého chcete vytvořit aplikaci v Javě. Spuštěním následujícího příkazu vygenerujte projekt Java ze šablony maven-archetype-quickstart.
mvn archetype:generate -DgroupId=com.communication.lookup.quickstart -DartifactId=communication-lookup-quickstart -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false
Úloha generate vytvoří adresář se stejným názvem jako .artifactId V tomto adresáři obsahuje adresář src/main/java zdrojový kód projektu, src/test/java directory zdroj testů a pom.xml soubor je projektový objektový model nebo POM projektu.
Připojení k kanálu balíčků pro vývoj
Verze Public Preview sady SDK se publikuje do kanálu vývojového balíčku. Pokud se chcete připojit k vývojovému kanálu, otevřete soubor pom.xml v textovém editoru a přidejte vývojové úložiště do <repositories> pom.xml i <distributionManagement> oddílů, které můžete přidat, pokud ještě neexistují.
<repository>
<id>azure-sdk-for-java</id>
<url>https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-java/maven/v1</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
Možná budete muset soubor přidat nebo upravit settings.xml v ${user.home}/.m2
<server>
<id>azure-sdk-for-java</id>
<username>azure-sdk</username>
<password>[PERSONAL_ACCESS_TOKEN]</password>
</server>
Osobní přístupový token můžete vygenerovat pomocí oborů čtení a zápisu balíčku a vložit ho do značky<password>.
Podrobnější informace a další možnosti připojení k vývojovému kanálu najdete tady.
Nainstalujte balíček .
Do skupiny závislostí v souboru pom.xml přidejte následující prvky závislosti.
<dependencies>
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-communication-common</artifactId>
<version>1.0.0</version>
</dependency>
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-communication-phonenumbers</artifactId>
<version>1.2.0-beta.3</version>
</dependency>
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-identity</artifactId>
<version>1.2.3</version>
</dependency>
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-core</artifactId>
<version>1.41.0</version>
</dependency>
</dependencies>
properties V části se ujistěte, že váš projekt cílí na Maven verze 1.8 nebo novější.
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>
</properties>
Příklady kódu
Nastavení architektury aplikace
Z adresáře projektu:
- Přejděte do adresáře /src/main/java/com/communication/lookup/quickstart .
- Otevření souboru App.java v editoru
System.out.println("Hello world!");Nahrazení příkazu- Přidání
importdirektiv
Začněte následujícím kódem:
package com.communication.lookup.quickstart;
import com.azure.communication.phonenumbers.*;
import com.azure.communication.phonenumbers.models.*;
import com.azure.core.http.rest.*;
import com.azure.core.util.Context;
import com.azure.identity.*;
import java.io.*;
import java.util.ArrayList;
public class App
{
public static void main( String[] args ) throws IOException
{
System.out.println("Azure Communication Services - Number Lookup Quickstart");
// Quickstart code goes here
}
}
Ověření klienta
Klienta je možné ověřit pomocí připojovací řetězec získaného z prostředku Azure Communication Services na webu Azure Portal. Použití proměnné prostředí se doporučuje vyhnout vložení připojovací řetězec do prostého COMMUNICATION_SERVICES_CONNECTION_STRING textu v kódu. Zjistěte, jak spravovat připojovací řetězec vašeho prostředku.
// This code retrieves your connection string from an environment variable
String connectionString = System.getenv("COMMUNICATION_SERVICES_CONNECTION_STRING");
PhoneNumbersClient phoneNumberClient = new PhoneNumbersClientBuilder()
.connectionString(connectionString)
.buildClient();
Případně se můžete ověřit pomocí ověřování Microsoft Entra. DefaultAzureCredentialBuilder Použití je nejjednodušší způsob, jak začít s ID Microsoft Entra. Název prostředku můžete získat z prostředku Azure Communication Services na webu Azure Portal.
// You can find your resource name from your resource in the Azure portal
String endpoint = "https://<RESOURCE_NAME>.communication.azure.com";
PhoneNumbersClient phoneNumberClient = new PhoneNumbersClientBuilder()
.endpoint(endpoint)
.credential(new DefaultAzureCredentialBuilder().build())
.buildClient();
Vyhledání formátování telefonního čísla
Pokud chcete vyhledat národní a mezinárodní formátování čísla, zavolejte searchOperatorInformation z čísla PhoneNumbersClient.
ArrayList<String> phoneNumbers = new ArrayList<String>();
phoneNumbers.add("<target-phone-number>");
// Use the free number lookup functionality to get number formatting information
OperatorInformationResult formattingResult = phoneNumberClient.searchOperatorInformation(phoneNumbers);
OperatorInformation formattingInfo = formattingResult.getValues().get(0);
Nahraďte <target-phone-number> telefonním číslem, které hledáte, obvykle číslo, na které chcete poslat zprávu.
Upozorňující
Zadejte telefonní čísla v mezinárodním standardním formátu E.164, například +14255550123.
Vyhledání informací o operátoru čísla
Pokud chcete vyhledat informace o operátorovi telefonního čísla, zavolejte searchOperatorInformationWithResponse z PhoneNumbersClienttelefonu a předejte IncludeAdditionalOperatorDetailstrue možnost.
OperatorInformationOptions options = new OperatorInformationOptions();
options.setIncludeAdditionalOperatorDetails(true);
Response<OperatorInformationResult> result = phoneNumberClient.searchOperatorInformationWithResponse(phoneNumbers, options, Context.NONE);
OperatorInformation operatorInfo = result.getValue().getValues().get(0);
Upozorňující
Použití této funkce bude účtovat poplatky za váš účet.
Použití informací o operátoru
Teď můžete použít informace o operátoru. Pro účely tohoto rychlého startu můžeme do konzoly vytisknout některé podrobnosti.
Nejprve můžeme vytisknout podrobnosti o formátu čísla.
System.out.println(formattingInfo.getPhoneNumber() + " is formatted "
+ formattingInfo.getInternationalFormat() + " internationally, and "
+ formattingInfo.getNationalFormat() + " nationally");
V dalším kroku můžeme vytisknout podrobnosti o telefonním čísle a operátorovi.
String numberType = operatorInfo.getNumberType() == null ? "unknown" : operatorInfo.getNumberType().toString();
String operatorName = "an unknown operator";
if (operatorInfo.getOperatorDetails()!= null && operatorInfo.getOperatorDetails().getName() != null)
{
operatorName = operatorInfo.getOperatorDetails().getName();
}
System.out.println(operatorInfo.getPhoneNumber() + " is a " + numberType + " number, operated in "
+ operatorInfo.getIsoCountryCode() + " by " + operatorName);
Informace o operátoru můžete použít také k určení, zda se má odeslat SMS. Další informace o odesílání sms najdete v rychlém startu sms.
Spuštění kódu
Spusťte aplikaci z terminálu nebo příkazového okna pomocí následujících příkazů: Přejděte do adresáře obsahujícího soubor pom.xml a zkompilujte projekt.
mvn compile
Pak balíček sestavte.
mvn package
Pokud chcete aplikaci spustit, použijte příkaz mvn .
mvn exec:java -D"exec.mainClass"="com.communication.lookup.quickstart.App" -D"exec.cleanupDaemonThreads"="false"
Ukázkový kód
Ukázkovou aplikaci si můžete stáhnout z GitHubu.
Začněte s klientskou knihovnou Telefon Numbers pro Python a vyhledejte informace o operátorech telefonních čísel, která se dají použít k určení, jestli a jak s tímto telefonním číslem komunikovat. Podle těchto kroků nainstalujte balíček a vyhledejte informace o telefonním čísle operátora.
Poznámka:
Najděte kód pro tento rychlý start na GitHubu.
Požadavky
- Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
- Python 3.7+.
- Aktivní prostředek služby Communication Services a připojovací řetězec. Vytvořte prostředek komunikační služby.
Kontrola požadovaných součástí
V terminálu nebo příkazovém okně spusťte python --version příkaz a zkontrolujte, jestli je Python nainstalovaný.
Nastavení
Pokud chcete nastavit prostředí pro odesílání vyhledávacích dotazů, proveďte kroky v následujících částech.
Vytvoření nové aplikace v Pythonu
V terminálu nebo příkazovém okně vytvořte pro aplikaci nový adresář a přejděte na něj.
mkdir number-lookup-quickstart && cd number-lookup-quickstart
Pomocí textového editoru vytvořte soubor volaný number_lookup_sample.py v kořenovém adresáři projektu a přidejte následující kód. Zbývající kód rychlého startu se přidá do následujících částí.
import os
from azure.communication.phonenumbers import PhoneNumbersClient
try:
print('Azure Communication Services - Number Lookup Quickstart')
# Quickstart code goes here
except Exception as ex:
print('Exception:')
print(ex)
Nainstalujte balíček .
V adresáři aplikace nainstalujte pomocí příkazu klientskou knihovnu azure Communication Services Telefon Numbers pro balíček Pythonupip install.
pip install azure-communication-phonenumbers==1.2.0b2
Příklady kódu
Ověření klienta
Klienta je možné ověřit pomocí připojovací řetězec získaného z prostředku Azure Communication Services na webu Azure Portal. Použití proměnné prostředí se doporučuje vyhnout vložení připojovací řetězec do prostého COMMUNICATION_SERVICES_CONNECTION_STRING textu v kódu. Zjistěte, jak spravovat připojovací řetězec vašeho prostředku.
# This code retrieves your connection string from an environment variable
connection_string = os.getenv('COMMUNICATION_SERVICES_CONNECTION_STRING')
try:
phone_numbers_client = PhoneNumbersClient.from_connection_string(connection_string)
except Exception as ex:
print('Exception:')
print(ex)
Případně je možné ověřit klienta pomocí ověřování Microsoft Entra. Použití objektu DefaultAzureCredential je nejjednodušší způsob, jak začít s Microsoft Entra ID a můžete ho pip install nainstalovat pomocí příkazu.
pip install azure-identity
Vytvoření objektu DefaultAzureCredential vyžaduje, abyste měli AZURE_CLIENT_ID, AZURE_CLIENT_SECRETa AZURE_TENANT_ID již nastaven jako proměnné prostředí s odpovídajícími hodnotami z vaší registrované aplikace Microsoft Entra.
Pokud chcete získat tyto proměnné prostředí, dozvíte se, jak nastavit instanční objekty z rozhraní příkazového řádku.
azure-identity Po instalaci knihovny můžete pokračovat v ověřování klienta.
from azure.identity import DefaultAzureCredential
# You can find your endpoint from your resource in the Azure portal
endpoint = 'https://<RESOURCE_NAME>.communication.azure.com'
try:
credential = DefaultAzureCredential()
phone_numbers_client = PhoneNumbersClient(endpoint, credential)
except Exception as ex:
print('Exception:')
print(ex)
Vyhledání formátování telefonního čísla
Pokud chcete vyhledat národní a mezinárodní formátování čísla, zavolejte search_operator_information z čísla PhoneNumbersClient.
formatting_results = phone_numbers_client.search_operator_information("<target-phone-number>")
Nahraďte <target-phone-number> telefonním číslem, které hledáte, obvykle číslo, na které chcete poslat zprávu.
Upozorňující
Zadejte telefonní čísla v mezinárodním standardním formátu E.164, například +14255550123.
Vyhledání informací o operátoru čísla
Pokud chcete vyhledat informace o operátorovi telefonního čísla, zavolejte search_operator_information z PhoneNumbersClienttelefonu a předejte include_additional_operator_detailsTrue možnost.
options = { "include_additional_operator_details": True }
operator_results = phone_numbers_client.search_operator_information("<target-phone-number>", options)
Upozorňující
Použití této funkce bude účtovat poplatky za váš účet.
Použití informací o operátoru
Teď můžete použít informace o operátoru. Pro účely tohoto rychlého startu můžeme do konzoly vytisknout některé podrobnosti.
Nejprve můžeme vytisknout podrobnosti o formátu čísla.
formatting_info = formatting_results.values[0]
print(str.format("{0} is formatted {1} internationally, and {2} nationally", formatting_info.phone_number, formatting_info.international_format, formatting_info.national_format))
V dalším kroku můžeme vytisknout podrobnosti o telefonním čísle a operátorovi.
operator_information = operator_results.values[0]
number_type = operator_information.number_type if operator_information.number_type else "unknown"
if operator_information.operator_details is None or operator_information.operator_details.name is None:
operator_name = "an unknown operator"
else:
operator_name = operator_information.operator_details.name
print(str.format("{0} is a {1} number, operated in {2} by {3}", operator_information.phone_number, number_type, operator_information.iso_country_code, operator_name))
Informace o operátoru můžete použít také k určení, zda se má odeslat SMS. Další informace o odesílání sms najdete v rychlém startu sms.
Spuštění kódu
Spusťte aplikaci z terminálu nebo příkazového python okna pomocí příkazu.
python number_lookup_sample.py
Ukázkový kód
Ukázkovou aplikaci si můžete stáhnout z GitHubu.
Řešení problému
Běžné dotazy a problémy:
- Změny proměnných prostředí se nemusí projevit v aplikacích, které už jsou spuštěné. Pokud si všimnete, že proměnné prostředí nefungují podle očekávání, zkuste zavřít a znovu otevřít všechny programy, které používáte ke spuštění a úpravě kódu.
- Data vrácená tímto koncovým bodem podléhají různým mezinárodním zákonům a předpisům, proto přesnost výsledků závisí na několika faktorech. Mezi tyto faktory patří to, jestli bylo číslo přeneseno, kód země a stav schválení volajícího. Na základě těchto faktorů nemusí být informace o operátorech dostupné pro některá telefonní čísla nebo můžou odrážet původního operátora telefonního čísla, nikoli aktuálního operátora.
Další kroky
V tomto rychlém startu jste se naučili:
- Vyhledání formátování čísel
- Vyhledání informací o operátorovi pro telefonní číslo
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro