Szybki start: wyszukiwanie informacji o operatorach dla numeru telefonu przy użyciu usług Azure Communication Services

Ważne

Ta funkcja usług Azure Communication Services jest obecnie dostępna w wersji zapoznawczej.

Interfejsy API i zestawy SDK w wersji zapoznawczej są udostępniane bez umowy dotyczącej poziomu usług. Zalecamy, aby nie używać ich w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą nie być obsługiwane lub mogą mieć ograniczone możliwości.

Aby uzyskać więcej informacji, zapoznaj się z dodatkowymi warunkami użytkowania dla wersji zapoznawczych platformy Microsoft Azure.

Rozpocznij pracę z biblioteką klienta Telefon Numbers dla języka JavaScript, aby wyszukać informacje o operatorach numerów telefonów, których można użyć do określenia, czy i jak komunikować się z tym numerem telefonu. Wykonaj następujące kroki, aby zainstalować pakiet i wyszukać informacje o operatorze dotyczące numeru telefonu.

Uwaga

Znajdź kod tego przewodnika Szybki start w witrynie GitHub.

Wymagania wstępne

• Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
• Node.js active LTS (wsparcie długoterminowe) i konserwacja LTS (zalecane wersje 8.11.1 i 10.14.1).
• Aktywny zasób usług komunikacyjnych i parametry połączenia. Utwórz zasób usług komunikacyjnych.

Sprawdzanie wymagań wstępnych

W terminalu lub oknie polecenia uruchom node --version polecenie , aby sprawdzić, czy Node.js jest zainstalowana.

Konfigurowanie

Aby skonfigurować środowisko do wysyłania zapytań wyszukiwania, wykonaj kroki opisane w poniższych sekcjach.

Tworzenie nowej aplikacji Node.js

W terminalu lub oknie polecenia utwórz nowy katalog dla aplikacji i przejdź do niego.

mkdir number-lookup-quickstart && cd number-lookup-quickstart

Uruchom polecenie npm init -y , aby utworzyć plik package.json z ustawieniami domyślnymi.

npm init -y

Utwórz plik o nazwie number-lookup-quickstart.js w katalogu głównym utworzonego katalogu. Dodaj do niego następujący fragment kodu:

async function main() {
    // quickstart code will go here
}

main();

Instalowanie pakietu

Użyj polecenia , npm install aby zainstalować bibliotekę klienta usługi Azure Communication Services Telefon Numbers dla języka JavaScript.

npm install @azure/communication-phone-numbers@1.3.0-beta.4 --save

Opcja --save dodaje bibliotekę jako zależność w pliku package.json .

Przykłady kodu

Uwierzytelnianie użytkownika

Zaimportuj Telefon NumbersClient z biblioteki klienta i utwórz jej wystąpienie przy użyciu parametry połączenia, które można uzyskać z zasobu usług Azure Communication Services w witrynie Azure Portal. Zaleca się użycie zmiennej środowiskowejCOMMUNICATION_SERVICES_CONNECTION_STRING, aby uniknąć umieszczania parametry połączenia w postaci zwykłego tekstu w kodzie. Dowiedz się, jak zarządzać parametry połączenia zasobu.

Dodaj następujący kod na początku number-lookup-quickstart.js:

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);

Wyszukiwanie formatowania numeru telefonu

Aby wyszukać informacje o operatorze numeru telefonu, zadzwoń searchOperatorInformation z obiektu PhoneNumbersClient.

let formattingResults = await phoneNumbersClient.searchOperatorInformation([ "<target-phone-number>" ]);

Zastąp <target-phone-number> ciąg numerem telefonu, do którego szukasz, zazwyczaj numerem, do którego chcesz wysłać wiadomość.

Ostrzeżenie

Podaj numery telefonów w formacie międzynarodowego standardu E.164, na przykład +14255550123.

Wyszukiwanie informacji o operatorach dla liczby

Aby wyszukać informacje o operatorze numeru telefonu, zadzwoń searchOperatorInformation z PhoneNumbersClientelementu , przekazując true opcję includeAdditionalOperatorDetails .

let searchResults = await phoneNumbersClient.searchOperatorInformation([ "<target-phone-number>" ], { "includeAdditionalOperatorDetails": true });

Ostrzeżenie

Korzystanie z tej funkcji spowoduje naliczenie opłaty za konto.

Używanie informacji o operatorach

Teraz możesz użyć informacji o operatorze. W tym przewodniku Szybki start możemy wydrukować niektóre szczegóły w konsoli programu .

Najpierw możemy wydrukować szczegóły dotyczące formatu liczb.

let formatInfo = formattingResults.values[0];
console.log(formatInfo.phoneNumber + " is formatted " + formatInfo.internationalFormat + " internationally, and " + formatInfo.nationalFormat + " nationally");

Następnie możemy wydrukować szczegóły dotyczące numeru telefonu i operatora.

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"));

Możesz również użyć informacji o operatorze, aby określić, czy wysłać wiadomość SMS. Aby uzyskać więcej informacji na temat wysyłania wiadomości SMS, zobacz przewodnik Szybki start dotyczący programu SMS.

Uruchamianie kodu

Uruchom aplikację z poziomu terminalu lub okna poleceń za node pomocą polecenia .

node number-lookup-quickstart.js

Przykładowy kod

Przykładową aplikację można pobrać z usługi GitHub).

Rozpocznij pracę z biblioteką klienta Telefon Numbers dla języka C#, aby wyszukać informacje o operatorach numerów telefonów, których można użyć do określenia, czy i jak komunikować się z tym numerem telefonu. Wykonaj następujące kroki, aby zainstalować pakiet i wyszukać informacje o operatorze dotyczące numeru telefonu.

Uwaga

Znajdź kod tego przewodnika Szybki start w witrynie GitHub.

Wymagania wstępne

• Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
• Najnowsza wersja biblioteki klienta platformy .NET Core dla systemu operacyjnego.
• Aktywny zasób usług komunikacyjnych i parametry połączenia. Utwórz zasób usług komunikacyjnych.

Sprawdzanie wymagań wstępnych

W terminalu lub oknie polecenia uruchom dotnet polecenie , aby sprawdzić, czy zestaw SDK platformy .NET jest zainstalowany.

Konfigurowanie

Aby skonfigurować środowisko do wysyłania zapytań wyszukiwania, wykonaj kroki opisane w poniższych sekcjach.

Tworzenie nowej aplikacji w języku C#

W terminalu lub oknie polecenia uruchom dotnet new polecenie , aby utworzyć nową aplikację konsolową o nazwie NumberLookupQuickstart. To polecenie tworzy prosty projekt języka C# "Hello World" z pojedynczym plikiem źródłowym, Program.cs.

dotnet new console -o NumberLookupQuickstart

Zmień katalog na nowo utworzony folder aplikacji i użyj dotnet build polecenia , aby skompilować aplikację.

cd NumberLookupQuickstart
dotnet build

Połączenie do źródła danych pakietów deweloperskich

Publiczna wersja zapoznawcza zestawu SDK jest publikowana w kanale informacyjnym pakietów deweloperskich. Źródło danych deweloperskich można dodać przy użyciu interfejsu wiersza polecenia NuGet, który dodaje go do pliku 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"

Bardziej szczegółowe informacje i inne opcje łączenia się ze źródłem danych deweloperskich można znaleźć w przewodniku współtworzenia.

Instalowanie pakietu

Nadal w katalogu aplikacji zainstaluj bibliotekę klienta usług Azure Communication Services Telefon Numbers dla pakietu .NET, używając następującego polecenia.

dotnet add package Azure.Communication.PhoneNumbers --version 1.3.0-beta.5

Dodaj dyrektywę using na początku Program.cs , aby uwzględnić Azure.Communication przestrzeń nazw.

using System;
using System.Threading.Tasks;
using Azure.Communication.PhoneNumbers;

Zaktualizuj Main sygnaturę funkcji w celu asynchronizacji.

internal class Program
{
    static async Task Main(string[] args)
    {
        ...
    }
}

Przykłady kodu

Uwierzytelnianie użytkownika

Telefon Liczbę klientów można uwierzytelniać przy użyciu parametry połączenia pozyskanych z zasobu usług Azure Communication Services w witrynie Azure Portal. Zaleca się użycie zmiennej środowiskowejCOMMUNICATION_SERVICES_CONNECTION_STRING, aby uniknąć umieszczania parametry połączenia w postaci zwykłego tekstu w kodzie. Dowiedz się, jak zarządzać parametry połączenia zasobu.

// 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 liczba klientów może również uwierzytelniać się za pomocą uwierzytelniania firmy Microsoft Entra. W przypadku tej opcji należy AZURE_CLIENT_SECRETskonfigurować zmienne środowiskowe , AZURE_CLIENT_IDi AZURE_TENANT_ID na potrzeby uwierzytelniania.

// Get an endpoint to our Azure Communication Services resource.
Uri endpoint = new Uri("<endpoint_url>");
TokenCredential tokenCredential = new DefaultAzureCredential();
client = new PhoneNumbersClient(endpoint, tokenCredential);

Wyszukiwanie formatowania numeru telefonu

Aby wyszukać krajowe i międzynarodowe formatowanie numeru, zadzwoń SearchOperatorInformationAsync z .PhoneNumbersClient

OperatorInformationResult formattingResult = await client.SearchOperatorInformationAsync(new[] { "<target-phone-number>" });

Zastąp <target-phone-number> ciąg numerem telefonu, do którego szukasz, zazwyczaj numerem, do którego chcesz wysłać wiadomość.

Ostrzeżenie

Podaj numery telefonów w formacie międzynarodowego standardu E.164, na przykład +14255550123.

Wyszukiwanie informacji o operatorach dla liczby

Aby wyszukać informacje o operatorze numeru telefonu, zadzwoń SearchOperatorInformationAsync z PhoneNumbersClientelementu , przekazując true opcję IncludeAdditionalOperatorDetails .

OperatorInformationResult searchResult = await client.SearchOperatorInformationAsync(new[] { "<target-phone-number>" }, new OperatorInformationOptions() { IncludeAdditionalOperatorDetails = true });

Ostrzeżenie

Korzystanie z tej funkcji spowoduje naliczenie opłaty za konto.

Używanie informacji o operatorach

Teraz możesz użyć informacji o operatorze. W tym przewodniku Szybki start możemy wydrukować niektóre szczegóły w konsoli programu .

Najpierw możemy wydrukować szczegóły dotyczące formatu liczb.

OperatorInformation formattingInfo = formattingResult.Values[0];
Console.WriteLine($"{formattingInfo.PhoneNumber} is formatted {formattingInfo.InternationalFormat} internationally, and {formattingInfo.NationalFormat} nationally");

Następnie możemy wydrukować szczegóły dotyczące numeru telefonu i operatora.

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"}");

Możesz również użyć informacji o operatorze, aby określić, czy wysłać wiadomość SMS. Aby uzyskać więcej informacji na temat wysyłania wiadomości SMS, zobacz przewodnik Szybki start dotyczący programu SMS.

Uruchamianie kodu

Uruchom aplikację z poziomu terminalu lub okna poleceń za dotnet run pomocą polecenia .

dotnet run --interactive

Przykładowy kod

Przykładową aplikację można pobrać z witryny GitHub.

Rozpocznij pracę z biblioteką klienta Telefon Numbers dla języka Java, aby wyszukać informacje o operatorach numerów telefonów, których można użyć do określenia, czy i jak komunikować się z tym numerem telefonu. Wykonaj następujące kroki, aby zainstalować pakiet i wyszukać informacje o operatorze dotyczące numeru telefonu.

Uwaga

Znajdź kod tego przewodnika Szybki start w witrynie GitHub.

Wymagania wstępne

• Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
• Zestaw Java Development Kit (JDK) w wersji 8 lub nowszej.
• Apache Maven.
• Aktywny zasób usług komunikacyjnych i parametry połączenia. Utwórz zasób usług komunikacyjnych.

Sprawdzanie wymagań wstępnych

W terminalu lub oknie polecenia uruchom mvn -v polecenie , aby sprawdzić, czy narzędzie Maven jest zainstalowane.

Konfigurowanie

Aby skonfigurować środowisko do wysyłania zapytań wyszukiwania, wykonaj kroki opisane w poniższych sekcjach.

Tworzenie nowej aplikacji Java

W terminalu lub oknie polecenia przejdź do katalogu, w którym chcesz utworzyć aplikację Java. Uruchom następujące polecenie, aby wygenerować projekt Java na podstawie szablonu maven-archetype-quickstart.

mvn archetype:generate -DgroupId=com.communication.lookup.quickstart -DartifactId=communication-lookup-quickstart -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false

Zadanie "generate" tworzy katalog o takiej samej nazwie jak artifactId. W tym katalogu katalog src/main/java zawiera kod źródłowy projektu, src/test/java directory zawiera źródło testowe, a pom.xml plik jest projektem Project Object Model lub POM.

Połączenie do źródła danych pakietów deweloperskich

Publiczna wersja zapoznawcza zestawu SDK jest publikowana w kanale informacyjnym pakietów deweloperskich. Aby nawiązać połączenie ze źródłem danych deweloperskich, otwórz plik pom.xml w edytorze tekstów i dodaj repozytorium deweloperskie do sekcji i <distributionManagement> pom.xml<repositories>, które można dodać, jeśli jeszcze nie istnieją.

<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że być konieczne dodanie lub edytowanie settings.xml pliku w pliku ${user.home}/.m2

<server>
  <id>azure-sdk-for-java</id>
  <username>azure-sdk</username>
  <password>[PERSONAL_ACCESS_TOKEN]</password>
</server>

Możesz wygenerować osobisty token dostępu z zakresami odczytu i zapisu pakietu i wkleić go do tagu <password> .

Bardziej szczegółowe informacje i inne opcje łączenia się ze źródłem danych deweloperskich można znaleźć tutaj.

Instalowanie pakietu

Dodaj następujące elementy zależności do grupy zależności w pliku pom.xml .

<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>

Sprawdź sekcję, properties aby upewnić się, że projekt jest przeznaczony dla programu Maven w wersji 1.8 lub nowszej.

<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>

Przykłady kodu

Konfigurowanie struktury aplikacji

Z katalogu projektu:

1. Przejdź do katalogu /src/main/java/com/communication/lookup/quickstart
2. Otwórz plik App.java w edytorze
3. Zastąp instrukcję System.out.println("Hello world!");
4. Dodawanie import dyrektyw

Użyj następującego kodu, aby rozpocząć:

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
    }
}

Uwierzytelnianie użytkownika

Klient można uwierzytelnić przy użyciu parametry połączenia pozyskanego z zasobu usług Azure Communication Services w witrynie Azure Portal. Zaleca się użycie zmiennej środowiskowejCOMMUNICATION_SERVICES_CONNECTION_STRING, aby uniknąć umieszczania parametry połączenia w postaci zwykłego tekstu w kodzie. Dowiedz się, jak zarządzać parametry połączenia zasobu.

// 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();

Alternatywnie możesz uwierzytelnić się przy użyciu uwierzytelniania firmy Microsoft Entra. Użycie metody DefaultAzureCredentialBuilder jest najprostszym sposobem rozpoczęcia pracy z identyfikatorem Entra firmy Microsoft. Nazwę zasobu można uzyskać z zasobu usług Azure Communication Services w witrynie 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();

Wyszukiwanie formatowania numeru telefonu

Aby wyszukać krajowe i międzynarodowe formatowanie numeru, zadzwoń searchOperatorInformation z .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);

Zastąp <target-phone-number> ciąg numerem telefonu, do którego szukasz, zazwyczaj numerem, do którego chcesz wysłać wiadomość.

Ostrzeżenie

Podaj numery telefonów w formacie międzynarodowego standardu E.164, na przykład +14255550123.

Wyszukiwanie informacji o operatorach dla liczby

Aby wyszukać informacje o operatorze numeru telefonu, zadzwoń searchOperatorInformationWithResponse z PhoneNumbersClientelementu , przekazując true opcję IncludeAdditionalOperatorDetails .

OperatorInformationOptions options = new OperatorInformationOptions();
options.setIncludeAdditionalOperatorDetails(true);
Response<OperatorInformationResult> result = phoneNumberClient.searchOperatorInformationWithResponse(phoneNumbers, options, Context.NONE);
OperatorInformation operatorInfo = result.getValue().getValues().get(0);

Ostrzeżenie

Korzystanie z tej funkcji spowoduje naliczenie opłaty za konto.

Używanie informacji o operatorach

Teraz możesz użyć informacji o operatorze. W tym przewodniku Szybki start możemy wydrukować niektóre szczegóły w konsoli programu .

Najpierw możemy wydrukować szczegóły dotyczące formatu liczb.

System.out.println(formattingInfo.getPhoneNumber() + " is formatted "
    + formattingInfo.getInternationalFormat() + " internationally, and "
    + formattingInfo.getNationalFormat() + " nationally");

Następnie możemy wydrukować szczegóły dotyczące numeru telefonu i operatora.

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);

Możesz również użyć informacji o operatorze, aby określić, czy wysłać wiadomość SMS. Aby uzyskać więcej informacji na temat wysyłania wiadomości SMS, zobacz przewodnik Szybki start dotyczący programu SMS.

Uruchamianie kodu

Uruchom aplikację z poziomu terminalu lub okna poleceń przy użyciu następujących poleceń: przejdź do katalogu zawierającego plik pom.xml i skompiluj projekt.

mvn compile

Następnie skompiluj pakiet.

mvn package

Aby wykonać aplikację, użyj mvn polecenia .

mvn exec:java -D"exec.mainClass"="com.communication.lookup.quickstart.App" -D"exec.cleanupDaemonThreads"="false"

Przykładowy kod

Przykładową aplikację można pobrać z witryny GitHub.

Rozpocznij pracę z biblioteką klienta Telefon Numbers dla języka Python, aby wyszukać informacje o operatorach numerów telefonów, których można użyć do określenia, czy i jak komunikować się z tym numerem telefonu. Wykonaj następujące kroki, aby zainstalować pakiet i wyszukać informacje o operatorze dotyczące numeru telefonu.

Uwaga

Znajdź kod tego przewodnika Szybki start w witrynie GitHub.

Wymagania wstępne

• Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
• Python 3.7+.
• Aktywny zasób usług komunikacyjnych i parametry połączenia. Utwórz zasób usług komunikacyjnych.

Sprawdzanie wymagań wstępnych

W terminalu lub oknie polecenia uruchom python --version polecenie , aby sprawdzić, czy język Python jest zainstalowany.

Konfigurowanie

Aby skonfigurować środowisko do wysyłania zapytań wyszukiwania, wykonaj kroki opisane w poniższych sekcjach.

Tworzenie nowej aplikacji w języku Python

W terminalu lub oknie polecenia utwórz nowy katalog dla aplikacji i przejdź do niego.

mkdir number-lookup-quickstart && cd number-lookup-quickstart

Użyj edytora tekstów, aby utworzyć plik o nazwie number_lookup_sample.py w katalogu głównym projektu i dodać następujący kod. Pozostały kod szybkiego startu zostanie dodany w poniższych sekcjach.

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)

Instalowanie pakietu

Nadal w katalogu aplikacji zainstaluj bibliotekę klienta usług Azure Communication Services Telefon Numbers dla pakietu języka Python przy użyciu pip install polecenia .

pip install azure-communication-phonenumbers==1.2.0b2

Przykłady kodu

Uwierzytelnianie użytkownika

Klient można uwierzytelnić przy użyciu parametry połączenia pozyskanego z zasobu usług Azure Communication Services w witrynie Azure Portal. Zaleca się użycie zmiennej środowiskowejCOMMUNICATION_SERVICES_CONNECTION_STRING, aby uniknąć umieszczania parametry połączenia w postaci zwykłego tekstu w kodzie. Dowiedz się, jak zarządzać parametry połączenia zasobu.

# 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)

Alternatywnie można uwierzytelnić klienta przy użyciu uwierzytelniania firmy Microsoft Entra. DefaultAzureCredential Użycie obiektu to najprostszy sposób rozpoczęcia pracy z identyfikatorem Entra firmy Microsoft i zainstalowanie go za pomocą pip install polecenia .

pip install azure-identity

DefaultAzureCredential Utworzenie obiektu wymaga, aby element AZURE_CLIENT_ID, AZURE_CLIENT_SECRETi AZURE_TENANT_ID został już ustawiony jako zmienne środowiskowe z odpowiednimi wartościami z zarejestrowanej aplikacji Firmy Microsoft Entra.

Aby dowiedzieć się, jak uzyskać te zmienne środowiskowe, możesz dowiedzieć się, jak skonfigurować jednostki usługi z poziomu interfejsu wiersza polecenia.

Po zainstalowaniu azure-identity biblioteki można kontynuować uwierzytelnianie 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)

Wyszukiwanie formatowania numeru telefonu

Aby wyszukać krajowe i międzynarodowe formatowanie numeru, zadzwoń search_operator_information z .PhoneNumbersClient

formatting_results = phone_numbers_client.search_operator_information("<target-phone-number>")

Zastąp <target-phone-number> ciąg numerem telefonu, do którego szukasz, zazwyczaj numerem, do którego chcesz wysłać wiadomość.

Ostrzeżenie

Podaj numery telefonów w formacie międzynarodowego standardu E.164, na przykład +14255550123.

Wyszukiwanie informacji o operatorach dla liczby

Aby wyszukać informacje o operatorze numeru telefonu, zadzwoń search_operator_information z PhoneNumbersClientelementu , przekazując True opcję include_additional_operator_details .

options = { "include_additional_operator_details": True }
operator_results = phone_numbers_client.search_operator_information("<target-phone-number>", options)

Ostrzeżenie

Korzystanie z tej funkcji spowoduje naliczenie opłaty za konto.

Używanie informacji o operatorach

Teraz możesz użyć informacji o operatorze. W tym przewodniku Szybki start możemy wydrukować niektóre szczegóły w konsoli programu .

Najpierw możemy wydrukować szczegóły dotyczące formatu liczb.

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))

Następnie możemy wydrukować szczegóły dotyczące numeru telefonu i operatora.

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))

Możesz również użyć informacji o operatorze, aby określić, czy wysłać wiadomość SMS. Aby uzyskać więcej informacji na temat wysyłania wiadomości SMS, zobacz przewodnik Szybki start dotyczący programu SMS.

Uruchamianie kodu

Uruchom aplikację z poziomu terminalu lub okna poleceń za python pomocą polecenia .

python number_lookup_sample.py

Przykładowy kod

Przykładową aplikację można pobrać z witryny GitHub.

Rozwiązywanie problemów

Typowe pytania i problemy:

• Zmiany zmiennych środowiskowych mogą nie obowiązywać w programach, które są już uruchomione. Jeśli zauważysz, że zmienne środowiskowe nie działają zgodnie z oczekiwaniami, spróbuj zamknąć i ponownie otworzyć wszystkie programy, których używasz do uruchamiania i edytowania kodu.
• Dane zwracane przez ten punkt końcowy podlegają różnym międzynarodowym przepisom prawnym i przepisom, dlatego dokładność wyników zależy od kilku czynników. Czynniki te obejmują, czy numer został przeniesieny, kod kraju i stan zatwierdzenia obiektu wywołującego. Na podstawie tych czynników informacje o operatorach mogą nie być dostępne dla niektórych numerów telefonów lub mogą odzwierciedlać oryginalnego operatora numeru telefonu, a nie bieżącego operatora.

Następne kroki

W tym przewodniku Szybki start pokazano, jak wykonać następujące działania:

• Wyszukiwanie formatowania liczb
• Wyszukiwanie informacji o operatorze dla numeru telefonu

Koncepcja wyszukiwania liczb

Zestaw SDK wyszukiwania liczb